DIGITAL UNIX 


Common Desktop Environment: 


Style Guide and Certification Checklist 
Order Number: AA-QTM3A-TE 


March 1996 


Product Version: DIGITAL UNIX Version 4.0 or higher 


Digital Equipment Corporation 
Maynard, Massachusetts 


Copyright © 1995 Digital Equipment Corporation 

Copyright © 1994, 1995 Hewlett-Packard Company 

Copyright © 1994, 1995 International Business Machines Corp. 
Copyright © 1994, 1995 Sun Microsystems, I nc. 

Copyright © 1994, 1995 Novell, Inc. 


All rights reserved. This product and related documentation are protected by copyright and distributed under licenses 
restricting its use, copying, distribution, and decompilation. No part of this product or related documentation may be 
reproduced in any form by any means without prior written authorization. 


RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the United States Government is subject tothe 
restrictions set forth in DFARS 252.227-7013 (c)(1)(ii) and FAR 52.227-19. 


THIS PUBLICATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR 
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS 
FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. 


The code and documentation for the DtComboB ox and DtSpinB ox widgets were contributed by I nterleaf, Inc. Copyright 
1993, I nterleaf, Inc. 


UNIX is a trademark exclusively licensed through X/Open Company, Ltd. 
OSF/Motif and Motif are trademarks of Open Software Foundation, Ltd. 
AIX is a trademark of International Business Machines Corp. 

HP/UX is a trademark of Hewlett Packard Company. 

Solaris is a trademark of Sun Microsystems, Inc. 

UnixWare is a trademark of Novell, Inc. 

Microsoft Windows is a trademark of Microsoft. 

OS/2 is a trademark of International Business Machines Corp. 

X Window System is a trademark of X Consortium, Inc. 

Copyright © 1989, 1990, 1993, 1994 Open Software F oundation, I nc. 


Although portions of this document use text excerpted or derived from the OSF/ Motif StyleGuide, by Open Software 
F oundation, Inc. (OSF ), with the permission of OSF, this text is not, and does not represent, such OSF/ Motif Style 
Guide 


Contents 


Part 1 —Style Guide 
1. Introduction to the Common Desktop Environment . 1 
Advantages of a Common User Interface............05. 1 
Relationship to X/Open Motif Style Guide.............. 


2. Input, Navigation, 
Selection, and Activation.....c0.ceeeeneeneenneeae 


Input Guidelines ............. 0.2000 ee 
NSVIGEtOMii. caeeet cue yytendoetua yas eawes ts wteed ee 
Mouse-Based Navigation..............0.0-0 ee aee 

K eyboard-Based Navigation ..............-.+..4-. 
SElISCHION AS hope wiv eye b eens peel OA ae eae eS ea 
Mouse-Based Multiple Selection............... 
Mouse-Based Range Selection ...........000e: 
Mouse-Based Discontiguous Selection.......... 


Component Activation......... 0.00002 eee eee 


Oo ON DDH UN HK LHL LF W 


Basic Activation... ... 0... ccc eee ee as 


MINGMONECS 4-23 Le SeweG une eave eine de ene Vin Renee 8 
CiECKBULION: 325.435 cw etes tise det eee y cee eee 8 
PU OMB ETON oo 2 al An beste ie ee aS! ll Basler 8 
GOUGC Risch then tine Sew awt bined ns bie ee see 9 

3. Drag and Drop isis ciscaca oe ove eewe eae eas 11 
Drag-and-Drop User Model...........-..00000 ee eaaes 11 
Drag-and-Drop Feedback ........... 000: c cee eee 12 
Type of Item Being Dragged .............-...-00005 13 
DOD ZOMG? seit sais yaad wale Sead an wae es tre ang 14 
Resulting ACIVILY: oi. 546045455 oye eea sees eea edhe 15 
SUCCESS OF FOUL Oe weds eee oe Pur eh ee SE ev ees oy 16 
Parts of a Diag leoivesteu se Sie ash ove wk eee eed eee AS 17 
Stace nGiCalOh. ews sek Jeohesa tase Beet eile eke 17 
Operation MdicatOrs. +... o4-<Sh5 aah aGoteg a heart eee 18 
SOULCS | NCIGALOP: ooo eet ee eee oF oes eRe 19 
Drag-and-Drop Mechanics ...........-::0 cece eee 22 
TY PCS! Soweto ud oy edad bedre ate yee eee 22 
ACHIONS 8 cin Loe eG ae dow te ete ee ee eee 22 
Matching Operations cess. veeeee bob bead peas es 23 
Determining Drag Sources ..............200 0 eee eee 24 
STOMP GHE SES 4. b.s-a0 verareta ha Ge aah tae al vabare ics 25 
Dal OGD OXCS sud ead Bae) ngs Pee bd as were Mts 27 
WVINGOWS 2.2 atte hts fe 2 ade ead HBR at tenes te ol 28 
Dragging and Dropping a Multiple Selection............ 28 


CDE: Style Guide and Certification Checklist 


Standard Supported Drop Zones. .........00 cece eee 
TRE Front:Panel oo yess tage ye ted eee dey cok aa ey 
Pile MandGen eve 064 cit ot ee a eet ee 
No Drop-Only Targets ...............2000 eee eee 

Mouse Button. USage ose eke ae dew ee a eee ee 

Placement Ubon DIOR: scxea daisies eve Saas eee ae ics 

ENGNG: Drags .54-3 juts oh nee eal ee tae owas Oe 

Performance Guidelines .......... 0.00: es 

Using Attachments in Your Application................ 
Attachment User Model.............00 0: e eee eee 
Attachment Functionality....................0005 

What Can BeAttached? ..................0.. 


What Happens When Something Is Attached? ... 
Attachments in Attachments ................. 
Editing and Saving Attachments .................. 
Executing Attachments. ..........-.....0005- 
Read-Only Attachments .................2-005 
Drag Load and Attachments.................. 


Attachment Menu Contents ............000 eae eee 


Contents 


vi 


File.M anager wine eee aed eine ie ee Ee ees ee 4 43 


Application Manager .............000 0c eee eee eee 45 
Front Panel and Subpanels.............-...00-005 45 
Minimized Window Icons............0.000 cee eee 46 
OEMGIGraphiGs: scat us Sasa tits YowG Sud BaGoers wanted 47 
Color USage iN. CONSiinic con daiae vee ae eee ct wa aa ics 48 
lcon: Color Palette: 2225 chose eeee bene eked en 48 
Dynamic Colors .cu4 2 s..o)coe8 poe e269 GG or BASE AS 49 
Design Philosophy and Helpful Hints ................. 50 
Designing with Color.............. 002 eee eee 51 
NGO SEI OS a Stave Sta ane ac og a fe ee ge NR a agg 51 
Designing Your Applicationlcon .................. 52 
Designing Your Application Group!lcon............. 53 
Designing Your Document ICONS... 1.6... cee 54 
International ICONS ........... 00: ee 54 
Differences with Other Platforms.................. 55 
Implementation of Requiredlcons.................0-- 56 
FOTN AUS sf ne Sao er ere aa ta ea rere Sn aed Op een ec a 56 
RESOIUMONG stio.iie tiie suai omnes ae ia Mates by ie 58 
SILOS ee Ss i ace mls hn teat Bias Sy tent ey Are eee age oe 59 
Icon Naming Conventions...............222000 00 60 
PUIGINM EN ees center und oe pee ern ae ROS oe 2 the 62 
Optional Icons Sizes... 1.2... 0. ee 62 
Optional Front Panel Icon Style................... 63 


CDE: Style Guide and Certification Checklist 


Achieving the Etched Look................... 63 


Evolving the Etched Look...............-.0... 66 

5. Window and Session Control........0.20000000eeee 69 
Window Control Guidelines ...............02 cee eee 69 
Window Management Actions...............0+0005 70 
Window Decorations ............00 00 eee eee eee 70 
Window MenuS......... 0000: c eee eee 72 
Window ICONS... 1.2... ee 74 
Window Placement. ..............00 0 eee eee eee 74 
Workspace Management Guidelines. ...........000 eee 75 
Session Management Support ..............0000 eee yes) 
6. Application Design Principles ...........0.0000008 77 
Component Layout GuidelineS........ 0... cee eee 77 
Main Window: Layout.) os 92325 sey aGceGe denotes 77 
Menu Bar Layoutes wie ssa. cau pe es Seek Pee ey se 78 
Common Menu Typ6S .. 0.00 ccc cee ee tee 81 
FileMenu Contents....2..4c.se) 002. eeebede ben ae: 81 
<Object-type>and Selected Menu Contents.......... 83 
Edit Menu Contents. ................2000 0 eee ees 84 
VIGWIIMGN is 0. ny ah Sirs he we Pk teat Seay Ceres 86 
CODECS! MCR estanau tardies isa Bee aie erates at Ueber tcs 86 
Help Mena Conbents ..< 2 tej ies tome Ret eeeseadin tts 86 
Attachment Menu Contents ............-.00000005 88 
POD=UpsMenUS 3). oii: tie Seem ee Ge aoe dete Sek 88 


Contents vii 


General Menu Design Rules. ..........-.0 000 cee eee 91 


TOO) Bars as sideh ay dk oe eae weed Be ieee ge eae ye 93 
T60l'Bar- Guidelines: <4 6 reed aki eaea es 94 
Design Issues for Tool BarS... 1... cee es 94 
Too) Bar: Coiriponents: 2 242.2 se sive ela eed 223525 95 

LOO Bar -ContainiGh «.<csiseeve seus wena varet eis 95 
Tool Bar Button.......... 0.0.00. eee 96 
Pax Ase eked eee I Bisa o hia eat ttre ce elas cece tle te de 96 

Window Tithes 22024058 vyieaseeiee bat eewae sy stead od 96 

Work-in-Progress Feedback ...........00 00: eee eee eee 98 

General Application Design Rules ............0 eee eee 99 

Application. mstallation <..22020 5h 2¢euee evn sees wa Saby 100 

7. Common: Dialogs «234 soe coe dae deal peewee wat 101 
Dialog Box Design and Layout .................... 101 
Dialog Box Placement ............0000 0c eee aes 106 
Dialog Box Interaction........... 0.200002 eee aes 107 

Expandable Windows and Dialog Boxes................ 108 
Guidelines for Expandable Windows and Dialog Boxes. 108 
Components of Exapandable Windows.............. 109 

Primary and Secondary Panes.............-.. 109 
Expanding the Secondary Pane............... 110 
Resizing the Expanded Window or Dialog....... 111 
Expand Button .......... 2.0.00 cee eee 113 
Placing the Expand Button................... 113 


viii CDE: Style Guide and Certification Checklist 


Window State ......... 0c cee ee eee 114 


File Selection Dialog Boxes................0200 eee 114 
COMLGNUS F rk ea fF al a ues eae ete a aA ated enn astarlie 114 
File Selection Dialog Box Behavior................. 117 
DPS T NG Sra Serials eva eee eg Hits) Daren Seals Heaters aise 117 
BUCLON ArGEIVOUIOM s:scsvetay Sanit isi eye oie aN aan vated aes 118 
Selection and Navigation..................000005- 118 
Guidelines for Specific File Selection Dialog Box Uses . 119 

Open Didl0Giss e+ viendo ayes eew ees setae es 119 
SaveAs Dialog... «.2ccieve eyesea saoe eared he 120 
Directory Selection Dialog ................... 120 

PINE Dialog BOxe. o 3. cus oI et Abbe eee eed Ss eRe 121 
Standard Print Menu Items for Applications......... eal 
Guidelines for Common Print Dialog Functions....... 121 
Guidelines for Application-Specific Print Dialog Box 

PPUIVCEIOMS fp og ct see ae eh Ste ae Ga Aes Baiada 124 
Optional Pidlds e.cusucawseiee be vies Hae awe Le 124 
Some Samples bayouts 23 07sieetew. sit eeeveacie tes 125 

The Properties Didl0Qin vende t.ise eve ease eae Yea dds 128 
GUldelines: 24.542 cces sere vecws ee Ste oie ieee Gl ck 128 

The About Dialog Box.... 0.2... .. 0.0. 129 
Guidelines for the About Dialog Box................ 129 

8. Application MessageS........0000eeeeee eee eee 131 

Error Messages and Informational Messages ........... 131 


Contents ix 


Error MGssages <1 .ace ie hina athe len cin Gina ane o's bin Sea ee 4 132 


Guidelines for Error Messages ...........--++0005- 132 
Access tO'OnIING@ HAD cu. neregst ah eae 134 
Bre) Biull HVAC 0. ieee tine 2 aie eee Sg de ta i eed ee 135 
Informational Messages ......... 0000: eee 135 
Guidelines for Informational Messages ............. 136 
Other Message Dialogs ...........-.:000 eee eee 136 
Work-in-Progress Feedback..........-.:000e sees 138 

9. Designing for Accessibility .........000ceeeeeeeaee 141 
ACCOSSIDINNY 3 e 3 ceceee eee edhe st eyeSues chee eared $< 141 
Access and the Style Guide. ................22200000- 142 
Physical) Disabilities: .¢.4.2 2142s) 2oewk PONS bed ee RRS 142 
GUE seat ti ek Poohes st 3s weit eS ae a ose 143 
ViStial Disab NES ¥.4.26 20s 5 g:e-c.gtt MSS aes a Gotta les dos ahh epee g 143 
GUIGEINES 5 or paw tes ia eee Oda er ook Sek Genes 144 
Hearing Disabilities ..............0. 02.2 c eee ee 144 
GUldEINES: os hey doe ce eee eee Ewe bi eee ew eee ws 145 
Language, Cognitive, and Other Disabilities............ 145 
GUESS 05 toot ae oie os Siew ait ce BA ea eg ele 146 
Existing Keyboard Access Features...........--.000-. 146 
(SUGGS aie ene are ndusas Pet ceade ahs he ere livers og tata ee ce 147 
Resources for More! nformation on Accessibility......... 147 
OFGaNIZatliOnSa Yack thee Seesaw eee ieee eed 147 
CONTEFENCES os Sees thee rescer ses See piel eeed Me 148 


CDE: Style Guide and Certification Checklist 


BIbMOgraphy 2 asta see eG ee sete eink eee he We ees 148 
Part 2 —Certification Checklist 


10. Certification Checklist .......0..00ce eee 153 
How to Usethe Checklist ................000 00 eee 153 
PRG ACES hs ins as ote ah eS ate ae Be, 2 ok ee 154 
(PUUIM OUEIS o2e con's oe ck Jaded eta ee Meet SS ae wake 155 

Keyboard Focus Model......... 0. cee eee eee ees 155 
Input Device Model ............. 0.2.22 c eee 155 
NeVIGatiON rac 22 oe eke deca Gee eee ne eee ere 158 
Mouse-Based Navigation.................-000 aes 158 

K eyboard-Based Navigation ...................4-. 162 
Menu Draversdl iu ci4 es wy Pe aane hg dais ed eee 166 
Scrollable Component Navigation.................. 170 
Se CEION avs tove os arose ron Bee ee hee he aie tea hate eee 170 
Seleckion: Models 44a nol cea ea she Magee Sek 170 
Mouse-Based Single Selection ................ 171 
Mouse-Based Browse Selection..............-.. 171 
Mouse-Based Multiple Selection............... 171 
Mouse-Based Range Selection ............00: 172 
Mouse-Based Discontiguous Selection.......... 174 
Keyboard Selection... ccc ees 176 
Canceling a Selection ....... 0.0... 179 
Autoscrolling and Selection ............00000- 179 
Selecting and Deselecting All Elements......... 180 


Contents xi 


Using Mnemonics for Elements ............05. 180 


Selection ACHIONS sued es ese ave Pe eb aed sew eee Ss 180 
Pransfer' MOdets 33042564 os eee Pe et ye 182 
Clipboard Transfer .............-0000200 eee 183 
PUiirMalay: Pa SRM 9.246 cot kta, Panay Souls Beasts eG ink 185 
QUICK, GANSTORs verarcianh isa aly ae aie wun vedere tite 185 
Drag: Transter.o 242 teoes eee he peaked Mek 187 
Component Activation......... 0.00000 cee eee 191 
Basic ACIVALION s es04 id be eaten td yea wie ee Sead be 191 
ACCA GALOIS. «i set eg eeed Sens exe stesasewea edhe 192 
DWE EVCRTIONEGS oetotns hace anita ig ten oe Onc eal ge AE Pan od ae 192 
Tear-OfPACIWaLION.. ek. Eee Oy euee usta SG eee YESS 193 
ELE DACHVGUON cutshek Jo oheis be ee Meet oie ee ehe 194 
Dera ulEACUIVAUION 5 scs.c oan eis aah atostete eas ert epee 194 
Expert ACUIVANON ied vey cee ee es gee fee cee es 195 
Previewing and Autorepeat..............--00000e 196 
Cancel Activations i.e s2. esa ve we bi eedee ew enews 196 
Window Management .............--200 00s eee eee 197 
WINdOW SUDDORE ei iaies eu bw oh eta eh ee ee ek 197 
Window Decorations ............. 000: eee eee 197 
Window Navigation, ec. eee Sax tan alias aes 199 
LOONS aie fern ae Pak ee wile tee a Cale Bee ae ke ale eS 199 
Application Window Management ..............-+: 199 
Window Placement ................220000 ee 199 


xii CDE: Style Guide and Certification Checklist 


Window (Document) Clustering............... 200 


Window Management Actions ................ 201 
Session Management Support ............-..2.005- 202 
Application Design Principles..............-..000000- 202 
LOYVOUL. wivaccuee ones 28 Geis easel 4 ied weed dhe 202 
WGI: WWINGOWS dix orient ine atv aes wea eae ape tics 202 
WINdOW Titles: 2 o 25 setfous ee6e ce eee eked tek 204 

M CHUB al cits S22 eee tng mente a elas cree hile te hes 205 

File Menu Contents. ..............200000e ee 208 

Help Menu Contents................000+0055 214 
Attachment Menu Contents .................. 215 
POp-UD'MGNUS« ¢s.e Betas h Pewee eee eek baie 216 
DidlGg BOxKeS): du 2k Jeehess tase teed ig eg eens 220 
Menu DESIGN 2.4.5. 22.a-cattins aa aGcleG st Aas ate ests 221 
Dialog Box Design............. 000 c cee eee eee 223 

File Selection Dialog Box ...............-00.5 228 
About Dialog: Box: s2..c4 sere ehi ieee dw nen ew: 229 
Dialog Box Layout... ou 2cecek eee eee eee ees 230 
Designing Dragand Drop..............--2455 231 
PUAN Sic? a Sees es tea est etal A eee s 235 
DSC allots airius-scs wee alan h a Gv pie airtel Radars ees 235 
LIU CEN ON A 25 sears tere Geese ata halt as Parana Bh ale tor ae 235 
MISU alo 2:4 tye SM aah be Seats Sag Ree ON Bod ace ti Ue 238 
WOOl DaiSo2225.23.205 G7 eae ese ee eee ote Bes 239 


Contents 


xiii 


Expandable Windows..............000 0: eee eee eee 240 


MGsSa0CS ah oad bien Beea ied Pathe Bhatia alg i 242 
Work-in-Progress Feedback.............0000 ee aee 246 
Controls, Groups, and Models. ..........00 cee eee eee 247 
CHECKBULLOM: 224% obs 28-2 Mtn ies Sto cet Reed ea Muh 247 
COMIDOB OX is Ge iuste tao ere es ie eve ake ee ad, ates se his 248 
COMMANGBOXs 2 tuts oes ee ak te aa te toe ete Otel 249 
FileSelectiOnBox .......... 000 cee 249 
LSE smaciite agai wea te Save e wee a, wee 8 WR eae Ew LA ee eee 255 
Option BUUON. o:255.54¢045< 54 oye ends anewya Pease 256 
Pane WIndOWs: 20 Succeeds oe « hue etek Mee eyes 256 
PVN ss Sch e: o Biec Sine tothe Dh DS Se ns cet RDN A eA S, BRD 257 
PUSIBULION SS cactetSek Pe ghes sh sce Sets ee athe 257 
PRAGIO BULEON sac! csahee So se rssthea ath awe Seatatn ns ee ened 257 
BS tia Oil fia ete ety og een Orta oy dene Oe ing 2 258 
SCdle tect ins ie cus sea eas Ene eS cess 6 A ee 259 
SOW Bar wed oevd ee cw nore ee tee hah gw we eur: 261 
SEHeCHONB OX: 222 oe yee eee Se Eee eee ee 263 

SUN BOK kesh oh il thats 2 alee attecinee Bact Sts nits Heat te 5 Sibeee Soe 263 
TOM ah cia nae at ate ah Sih BAe necae ee are Say Be 265 
GaUGS fice ea etary arr eiha diye Pea arat ee ares 267 
PCCCSS| DUNE 2 eared, eras bane) Shas Soegha Bik evade eed fn ti 8 267 
A. Keyboard Functions ........00000ee eee 269 
B.. (Mouse FUNCUONS 32 ice tesdes daw indead caueie tee 281 


CDE: Style Guide and Certification Checklist 


Mouse Operations and Functions.............00000 ee 283 


Select and Adjust Binding ....................... 285 
Transfer Bindings 244203 es 3 Pe ae AG et oy es 287 
MGHU NB IMOINGS! .is.0 cide aie ea eyes Adel a i eed ee Se 288 
PEVUGOS <x tata teva ex Diarra Sots Weta Sere Gocco Mais Decne Siruda era Sind ant th 289 


Contents xv 


CDE: Style Guide and Certification Checklist 


Figures 


Figure 3-1 
Figure 3-2 
Figure 3-3 
Figure 3-4 
Figure 3-5 
Figure 3-6 
Figure 3-7 
Figure 3-8 
Figure 4-1 
Figure 4-2 


Figure 4-3 


Figure 4-4 


Figure 4-5 


Figure 4-6 


Drag icon showing the object being dragged ............ 13 
Example of atext dragicon............000 cece ee eee 14 
Example of a cannot pointer dragicon................. 14 
Example of drop zone feedback from the Front Panel. .... 15 
Example drag icon showing the three parts............. 17 
Examples of copy (left) and link operation indicators..... 18 


Example of a scrolling list with an item selected for dragging 26 
Example Calendar Appointment Editor dialog box....... 27 
Screen shot of the desktop environment................ 42 


Collection of icons at sizes 32x32 and 16x16 as used in File 
MAMAGQER he 25 dice: eg les Peace mpaten aed ahsdesca ta eee Gon ade d eae te poze 44 


Examples of application group icons from Application Manager 
45 


Partial screen shot of Front Panel with the Personal Applications 


Subpanel Open. ... 0.2... ees 46 
Minimized window icons for Terminal, Text Editor, Calendar, 

and FileManager........... 0006 cece eee eee 47 
Example of a tool bar used in the Calendar application... 47 


xviii 


Figure 4-7 


Figure 4-8 
Figure 4-9 


Figure 4-10 
Figure 4-11 


Figure 4-12 
Figure 4-13 
Figure 4-14 
Figure 4-15 


Figure 4-16 
Figure 4-17 


Figure 4-18 
Figure 4-19 
Figure 4-20 


Figure 5-1 
Figure 5-2 
Figure 5-3 
Figure 6-1 
Figure 7-1 
Figure 7-2 


Icon Editor, showing the 22 Common Desktop Environment 


colors available for icONS ...........0 00 cee eee eee ee 49 
Example of dynamic color shadows ..............00000 50 
Calendar icon in black and white outline style on left and the 
desktop gray styleon right ........ 0.0.00. cee eee ees 51 
Examples of three-dimensional icons in the desktop...... 52 
Outline style converted to Common Desktop Environment style, 
in XPM and XBM formats............-0.00 cee eee eee 52 
Examples of application icons used in the desktop ....... 53 
Examples of application group icons..............0508 53 
Examples of document icons used in the desktop ........ 54 
Monochrome (XBM) bitmaps, with foreground reversal 
CONSEQUENCES ia, Hike Se aieda Gia cu dGla ReaG eee ee 58 
Example of a minimum required set of icons for Mailer... 61 


Example of a left-aligned 32x32 icon with a tag on the right side 
62 


Example of an icon lighted from the top left edge........ 64 
Applying the bottomShadow and topShadow colors ...... 65 
Example of anchoring page while letting pencil protrude from 

SUM ACC ais cdi: Stas Seated on edte Sed ba bea a 66 
Example primary window decorations...............4. 71 
Example secondary window decorations ............... 72 
Sample window menu ...........00 0c cee ee 72 
Example from Common Desktop Environment Calendar.. 94 


An example of using a Category option menu inadialog.. 105 


Calendar Appointment E ditor primary pane with E xpand button 
(MONE) na recctin: wana ened diate ace die date a Rew i eet what 110 


CDE: Style Guide and Certification Checklist 


Figure 7-3 


Figure 7-4 
Figure 7-5 
Figure 7-6 
Figure 7-7 


Figure 7-8 
Figure 7-9 
Figure 8-1 
Figure 8-2 


Figures 


Calendar Appointment Editor with expand button (Less) and 


primary and secondary panes.............0:0:0 eee eee 112 
Example of an Open file selection dialog box............ 115 
A basic print dialog. box .......... 0... eee 122 
Example print dialog box layout for general printing..... 126 


Example print dialog box layout for printing from applications 
127 


Example About dialog box.............0 000 e eee eee 130 
About dialog box with a More button ...............05. 130 
Anerror dialog Dox. .......... 000 cece eee eee 132 


An informational message in the lower margin of a window. 136 


xix 


CDE: Style Guide and Certification Checklist 


Tables 


Table P-1 
Table 3-1 
Table 4-1 
Table 4-2 
Table 4-3 
Table 4-4 
Table 10-1 


Table 10-2 


Table 10-3 
Table 10-4 
Table 10-5 
Table 10-6 
Table A-1 
Table A-2 
Table A-3 


Typographic Conventions .......... 00 eee eee eens Xxvi 
The possible drag icons shown with generic source indicators. 21 


RGB Values for Common Desktop Environment |con Colors 56 


Icon Sizes and Usage.... 1.2.2.6... cece 59 
Minimum Required Icon Set .......... 0.000: e eee eee 60 
Icon Name Conventions............ 00000 c eee eee 60 
Common Desktop Environment Window Decoration 
GONVENTIONS iii os a and Slave Ga baa ees eaeowe 198 
Common Desktop Environment Window Management 
CONVENCIONS wisi a ho eS eed Pea SR vee eA 201 
Dialog Box Title Conventions ...............0-0- eee 223 
File Selection Dialog Box Labels..............-.-0.04. 254 
Navigation in aSpin Box........... 0.000 e eee eee 264 
Keyboard Mappings for Server-Level Access Features.... 268 
Keyboard Functions and Key Engravings .............. 269 
Mnemonic Assignments for menu Choices ............. 278 
Keyboard Mappings for Space Bar and Enter Key ....... 280 


Table B-1 
Table B-2 
Table B-3 


Table B-4 
Table B-5 


Mouse Operations and Functions.............00000 ees 283 
Select and Adjust Key Bindings ..............-....04. 285 


Key Bindings When TRANSFER is Assigned Mouse Button 2 
287 


Key BindIngS «A003 ies ela aos sa pete 287 
Menu Bindings. .0.. itv oat duiend enna ea des 288 


CDE: Style Guide and Certification Checklist 


Preface 


The Common Desktop Environment: Style Guide and Cettification Checklist 
provides application design style guidelines and the list of requirements for 
Common Desktop Environment application-level certification. Common 
Desktop Environment requirements consist of the OSF/Motif Version 1.2 
requirements with Common Desktop Environment-specific additions. 


The checklist describes keys using a mode! keyboard mechanism. Wherever 
keyboard input is specified, the keys are indicated by the engravings on the 
OSF/Motif model keyboard. Mouse buttons are described using a virtual 
button mechanism to better describe behavior independent from the 
number of buttons on the mouse. 


Who Should Use This Book 


This book provides information to assist the application designer in 
developing consistent applications and behaviors within the applications. 


Before You Read This Book 


As you compare the behavior of your application to the requirements in this 
checklist, you may want to consult the OSF/ Motif Style Guide (Revision 
1.2) for additional style considerations. 


By default, this checklist assumes that your application is being designed 
for a left-to-right language environment in an English-language locale. 
Some sections of the checklist may require appropriate changes for other 
locales. 


The Style Guide Part of the book refers to checklist items in Chapter 10. 
Each checklist item is labeled with numbers or letters. The numbered items 
correspond to the checklist items from the OSF/ Motif Style Guide, Revision 
1.2. The Common Desktop Environment-specific additions are labeled with 
alphabetic identifiers. The checklist items references are followed by the 
page number where the checklist item appears. 


How This Book Is Organized 


This book consists of two parts and appendices. Explanations of the 
sections of the book follow: 


Part 1, “Style Guide,” describes style considerations you should follow 
when designing applications for the Common Desktop Environment. 


Chapter 1, “Introduction to the Common Desktop Environment,” is 
an introduction to the checklist and how to use it. 


Chapter 2, “Input, Navigation, Selection, and Activation,” provides 
information on the keyboard focus model and the input device model, 
mouse-based and keyboard-based navigation, menu traversal, scrollable 
component navigation, selection and transfer models, selection actions, and 
basic activation. 


Chapter 3, “Drag and Drop,” provides information on incorporating drag 
and drop into your application. 


Chapter 4, “Visual Design,” provides information on designing icons and 
other visuals consistent with the Common Desktop Environment style. 
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Chapter 5, “Window and Session Control,” provides information on 
window support, window decorations, window navigation, icons, application 
window management, and session management support. 


Chapter 6, “Application Design Principles,” provides information on 
layout, interaction, support for alternative visuals, messages, and work-in- 
progress feedback. 


Chapter 7, “Common Dialogs,” provides information on creating dialog 
boxes. 


Chapter 8, “Application Messages,” provides information on ways to 
provide feedback to the user. 


Chapter 9, “Designing for Accessibility,” provides information on 
making software applications accessible to people with disabilities. 


Part 2, “Certification Checklist,” is the certification checklist, which 
consists of a checklist divided into several topics: 


Chapter 10, “Certification Checklist,” provides the list of requirements 
for Common Desktop Environment application-level certification. 


Appendix A, “Keyboard Functions,” provides information on keyboard 
functions and keyboard engravings. 


Appendix B, “Mouse Functions,” provides information on mouse 
functions. 


WhatTypographic Changesand Symbols Mean 
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The following table describes the type changes and symbols used in this 
book 


TableP-1 Typographic Conventions 


Typeface 

or Symbol Meaning Example 

AaBbCc123  Thenames of commands, files, Edit your .1login file. 
and directories; on-screen Usels -a tolist all files. 
computer output system% You have mail. 

AaBbCc123 Command-line placeholder: To delete a file, type rm 
replace with a real name or filename. 
value 

AaBbCcl123 Book titles, new words or Read Chapter 6 in User's Guide. 
terms, or words to be These are called class options. 
emphasized You must be root to do this. 


Code samples are included in boxes and may display the following: 


& UNIX C shell prompt system’ 

$ UNIX Bourne and Korn shell systems 
prompt 

# Superuser prompt, all shells system# 
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Intoductionto the Common 
Desktop Environment 1 


The Common Desktop Environment is a graphical user interface for 
UNIX™ in its various flavors (AlIX™, HP/UX™, Solaris™, UnixWare™, 
etc.). UNIX is a powerful and portable operating system. The desktop now 
brings unparalleled ease of use to UNIX. 


The desktop has been jointly developed by Hewlett-Packard, |BM, Novell 
and Sun Microsystems. It is being adopted as a standard operating 
environment by these companies and many others in the UNIX workstation 
market. 


Advantages ofa Common User Interface 


The desktop interface brings greater ease-of-use and a consistent interface 
to UNIX. This provides many advantages to both end users and application 
developers. Among these advantages are: 


© An easier to use interface enables users to learn the system quickly and 
use it efficiently. 


* Consistency between UNIX platforms enables users to move from one 
computer to another with minimal difficulty. It also enables 
programmers to write a single application that can be compiled for each 
platform, significantly reducing development effort. 


© The desktop provides as much consistency as possible with the Microsoft 
Windows™ and IBM OS/2™ environments. This enables users to easily 
move between these environments and the desktop. 
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¢ Unlike many competing operating systems, several built-in productivity 
applications enable the desktop user to be productive before buying 
application software. 


© The desktop specifications have been submitted to the X/Open standards 
organization, ensuring that desktop is “open” and will not tie the user to 
proprietary solutions. 


Relationship to X/Open Motif Style Guide 


The desktop user interface follows the X/Open Motif guidelines. Motif, 
however, does not define a desktop, only the basic behaviors for applications 
and widgets. The Style Guide and Certification Checklist defines the 
guidelines that allow an application to integrate well with the desktop. 
Thus, to write a desktop-conforming application, you should follow both the 
OSF/ Motif Style Guide Revision 1.2 and the Common Desktop 
Environment: Style Guide and Cettification Checklist. 


Compliance with the desktop interface guidelines is voluntary and self- 
regulated. There is no formal certification process. Applications that meet 
all the required guidelines in this style guide and the OSF/ Motif Style 
Guide can be considered desktop compliant. 


Priorities have been assigned to each guideline: Required,recommended, 
and optional. 
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Input, Navigation, 
Selection, and Activation 2 


Input devices have different actions depending on which part of the 
interface the user is interacting with. Usually, mouse users can access 
windows and controls more easily than keyboard users, due to the inherent 
flexibility in mouse manipulation. Keyboard users must use specific keys to 
move the cursor in the application. 


Users have to move pointers and cursors within the interface to indicate 
where actions should occur. To do so, users employ navigation methods that 
vary, depending on the cursor’s location in the interface. Therefore, 
navigation refers to how users move pointers and cursors within the 
interface. 


Users often need to indicate which element of the interface they want to 
interact with. Sdection enables users to identify individual or multiple 
elements for subsequent interaction. 


Activation refers to using controls to perform actions. When a user chooses 
a button or chooses an item from a menu, for example, the user is 
activating those controls. 


The following sections outline Common Desktop Environment requirements 
for input, navigation, selection, and activation. 
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Input Guidelines 


Navigation 


Required 


Virtual keys are names for generic operations that the user can perform 
through the interface. They may be mapped to one or more physical key 
combinations. Application developers are strongly urged to provide support 
for Help, Properties, Undo, Cut, Copy, and Paste if their application has 
functions corresponding to these virtual keys. Other virtual keys may be 
supported as appropriate. 


a: Components and applications that have functions corresponding to 
the Motif/Common Desktop Environment virtual keys must support 
those keys.—page 156 


See the checklist item for a list of the virtual keys and their 
mappings. 


The desktop allows either BSelect or BMenu to be used to display menus. 
This capability has been added for users familiar with environments that 
provide a dedicated mouse menu button. 


For mouse-based navigation of text fields, the desktop has added a 
requirement that the text cursor be placed at the mouse cursor position, 
rather than at the beginning or the end of the text field. 


Mouse- Based Navigation 


Optiona 


Required 


Required 


b: BMenu Press or BMenu Click on a menu bar item displays the 
menu.—page 161 


c: BMenu Press or BMenu Click on an option button displays the option 
menu.—page 161 


d: BSelect Press on a text field causes the text cursor to be inserted at 
the mouse cursor position.—page 162 
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Keyboard-Based Navigation 


Optional 


Required 


Required 


Optional 


The requirement to support Tab as a navigation key within groups of push 
buttons has been added to make keyboard navigation easier for users who 
have difficulty with the standard keyboard. This change is intended to 
reduce the number of side-to-side traversals of the keyboard (from Tab to 
arrow keys and back) that a user must perform to navigate within a single 
dialog box. 


e: Each time a new window is opened, keyboard focus is placed in the 
first field or location within the window or in a default location, if this 
is appropriate for the particular window.—page 166 


f: The Tab key moves input focus between push buttons within a 
group.—page 166 


The arrow keys also move the selected focus per the OSF /Motif Style 
Guide, Revision 1.2. 


g: Use the Control, Shift, and Alt keys only to modify the function of 
other keys or key combinations.—page 166 


h: Use the Alt key only to provide access to mnemonics.—page 166 
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Required 


Required 


Required 


Required 


The desktop has incorporated two significant changes to selection in Motif. 
The first is that users may elect to have either Adjust or Transfer capability 
on the middle mouse button. In addition, the desktop integrates drag and 
select on the first mouse button. 


On a three-button mouse, button 2 is typically used for the BTransfer (or 
BSelect) function. However, in a Common Desktop Environment 
environment, the user may change an environment setting indicating that 
mouse button 2 should be used for the BAdjust function instead. BAdjust 
can be used to toggle the selection state of elements under the multiple 
selection model. 


The following guidelines describe the BAdjust behaviors. 


Mouse- Based Multiple Selection 


i: If your application contains collections that follow the multiple 
selection model, BAdjust is supported and behaves just like BSelect, 
when the BTransfer button is currently configured to behave as 
BAdjust.—page 171 


j: In a collection that uses multiple selection, clicking BSelect or 
BAdjust on an unselected element adds that element to the current 
selection. Clicking BSelect or BAdjust on a selected element removes 
that element from the current selection. Clicking BSelect or BAdjust 
moves the location cursor to that element.—page 172 


Mouse-Based Range Selection 


m: _ If your application contains collections that follow the range selection 
model, BAdjust is supported and behaves just like Shift+B Select, 
when the BTransfer button is currently configured to behave as 
BAdjust.—page 173 


n: — In acollection that uses range selection, when the user presses 
Shift+BSelect, or BAdjust, the anchor remains unchanged, and an 
extended range for the selection is determined, based on one of the 
extension models.—page 173 
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Required 


Reselect The extended range is determined by the anchor and 
the current pointer position, in exactly the same 
manner as when the selection was initially 
made.—page 174 


Enlarge OnlyThe selection can only be enlarged. The extended 
range is determined by the anchor and the current 
pointer position, but then is enlarged to include the 
current selection.—page 174 


Balance BeamA balance point is defined at the midpoint of the 
current selection. When the user presses Shift+BSelect 
or BAdjust on the opposite side of the balance point 
from the anchor, this model works exactly like the 
reselect model. When the user presses Shift+B Select, 
BAdjust, or starts a navigation action modified by 
Shift on the same side of the balance point as the 
anchor, this model moves the anchor to the opposite 
end of the selection and then works exactly like the 
reselect model.—page 174. 


When the user releases BSelect or BAdjust, the anchor does not move, 
all the elements within the extended range are selected, and all the 
elements outside of it are deselected.—page 174 


Mouse-Based Disc ontiguous Selection 


o: In acollection that uses discontiguous selection, BAdjust can be used 
to extend the range of a discontiguous selection. The extended range 
is determined in exactly the same way as when BAdjust is used to 
extend a range selection.—page 175 
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ComponentAc tivation 


The following guidelines have been provided to clarify double-click timing 
and mnemonics, to explain changes in activation of specific components, 
and explain behaviors of components that are new in CDE Motif. 


Basic Activation 
Required x: The time allowed to detect a double click (*doubleClickTime: 500) 
should be no less than 500 milliseconds.—page 192 


Mnemonics 


Required y: © Mnemonic characters must be chosen for ease-of-location within the 
text of a label. Wherever possible, use the first character of the label. 
If that is not possible, try to use the last character of the label, or if 
there is more than one word, the first character of the second word. 
After that, go through the label from the second character on until a 
unique mnemonic is found.—page 193 


CheckButton 


Required 7-1: Your application uses check buttons to select settings that are not 
mutually exclusive. A check button graphically indicates its state 
with the presence or absence of a check mark.—page 247 


A check button is used to select settings that are not mutually 
exclusive. The user needs to know whether the button is set or not. 


OptionBution 


Required 7-23: When the user presses BSelect or BMenu in an option button, the 
associated option menu is posted.—page 256 


BSelect Press is a consistent way of activating an option button. 


Required 7-24: When the user releases BSelect or BMenu within the same option 
button that the press occurred in, the associated option menu is 
posted if it was not posted at the time of the press. When the user 
releases BSelect or BMenu outside of the option button, the 
associated option menu is unposted.—page 256 
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BSelect Release or BMenu Release posts or unposts an option menu, 
depending on whether the release occurs inside the option button and 
whether the option menu was posted at the time of the press. 


Gauge 


Required ib: A gauge is similar to a scale except that a gauge is a display-only 
device with no user interactions. The appearance of a gauge is similar 
to a scale, but the gauge lacks a scale slider.—page 267 


Optional ic: Despite being a display-only device, a gauge should get keyboard 
focus so that the user can access Help or Settings for that 
control.—page 267 
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Drag and Drop 3 


Drag and drop enables the user to directly manipulate objects in the 
computing environment. This chapter discusses and provides guidelines for 
incorporating drag and drop into your application. If you plan to use drag 
and drop or attachments in your application, then you should read this 
chapter. 


You should be familiar with the description of Motif 1.2 drag and drop as 
covered in the OSF/ Motif Style Guide, Version 1.2. If you are not, read 
Section 4.3.4, “Drag Transfer,” in that book. Where differences occur, this 
chapter supersedes the OSF/ Motif Style Guide, Version 1.2. 


Drag-and-Drop User Model 


Direct manipulation of objects in the computing environment helps the user 
feel in control of the computer, which in turn helps the user feel more 
comfortable about trying new operations and about computers in general. It 
is also a more efficient method for peforming many operations. 


To understand the drag-and-drop user model, you must understand the 
following terms: 


drop zone’ An area of the workspace that accepts a dropped icon. Drop 
zones are usually represented by the control or icon graphic, 
such as the Trash Can or the Print Manager control. 


drag icon The composite cursor used during the drag. See “Parts of a 
Drag Icon” on page 17 for details. 
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Recommended 


Recommended 


In the Common Desktop Environment, the user can select and drag icons in 
File Manager, mail messages and attachments in Mailer, appointments in 
Calendar, and text from text editors or text fields. These items can be 
dropped onto any drop zone that accepts them. For example, a document 
icon from File Manager can be dropped onto a folder icon in File Manager, 
onto the Print Manager icon on the Front Panel, or on the attachment list 
in Mailer. 


When an item is dropped, some action happens with the dropped item. F or 
example, the document might get printed, moved, or attached. The action 
taken depends on the object being dragged and where it is dropped. 


dq: You should provide a drag-and-drop (DND) method for all objects 
represented as icons. Provide a DND method for all elements that the 
user can directly manipulate.—page 231 


dr: Any basic function that your application supports through drag and 
drop is also supported through menus, buttons, or dialog 
boxes.—page 231 


Drag and drop is considered an accelerator to functionality that is 
accessible through other user interface controls supported within your 
application. There should be no basic operation that is supported 
solely through drag and drop. 


Drag-and-Drop Feedback 
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Visual feedback to the user is one of the critical elements for making drag 
and drop work. Without clear visual feedback, it is difficult for the user to 
predict the results of a drag-and-drop operation. Visual feedback must also 
be timely. 


The user should be able to identify visually the following items during a 
drag-and-drop operation: 


® Type of item being dragged—The drag icon should show the user what 
type of item is being dragged. 


* Drop zone—The drop zone should visually indicate when the dragged 
item is over the drop zone, and whether the drop zone is valid or invalid 
for that item. 
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® Resulting activity—The drag icon should visually indicate what action 
will take place when the item is dropped. 


© Success or failure—When the item is dropped, transition effects should 
indicate the success or failure of the drop. 


Type of Item Being Dragged 


Required 


Recommended 


The visual feedback for drag and drop is based on the concept that what 
you see is what you drag. For example, if the user selects a folder icon in 
File Manager and starts dragging it, the drag icon should show the folder 
icon as part of the drag icon, as illustrated in Figure 3-1. 


al 
rm al 


Figure3-1 Drag icon showing the object being dragged 


dt: During a drag operation, your application changes the current pointer 
to a drag icon.—page 231 


du: During a drag operation, your application changes the current drag 
cursor to include a source indicator.—page 231 


While this may seem like an obvious behavior, it is critical to give users 
feedback showing exactly what they are dragging. Providing this kind of 
consistency makes drag and drop more predictable to the user. Text drags 
are the exception in that the actual text is not dragged. Figure 3-2 shows a 
text drag icon. 
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Drop Zone 


Figure3-2 Example of a text drag icon 


Applications are responsible for supplying a graphic to be used in the drag 
icon. This graphic is usually one of the icons already supplied with the 
application, such as the 32x32 icons used in File Manager to represent 
documents. The graphic used depends on what is being dragged. 


In cases where the user does not select an icon to start a drag, it is still 
appropriate to show a relevant graphic in the drag icon especially if that 
graphic will be used by the destination application upon drop. F or example, 
in Calendar Appointment Editor, the user can select an appointment from 
the scrolling list, which does not show icons. An appointment icon is used 
as part of the drag icon. If the appointment were dropped on File Manager, 
File Manager would display the appointment using the same graphic. 


The user needs to know when the dragged item is over a valid drop zone. 
There are two pieces to this feedback; the drag icon and the drop zone. The 
drag icon changes from an arrow to a cannot pointer when the user moves 
the drag icon over anything but a valid drop zone. This behavior is 
sometimes referred to as drag over feedback. On the desktop, there is no 
differentiation between invalid drop zones and something that is not ever a 
drop zone. Figure 3-3 shows a sample cannot pointer drag icon. 
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Figure3-3 Example of a cannot pointer drag icon 
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Recommended 


Recommended 


Optional 


Resulting Ac 


The drop zone feedback options (referred to as drag under feedback) 
indicate valid drop zones. The options include a solid line drawn around the 
site, a raised or lowered surface with a beveled edge around the drop zone, 
or drawing a pixmap over the drop zone. The beveled edge effect is used to 
make the drop zone look recessed. Figure 3-4 shows the recessed 
appearance. On the desktop, most drop zones use the recessed appearance 
when a drag icon is over the drop zone to indicate it is a valid drop zone. 


Figure3-4 Example of drop zone feedback from the Front Panel. 


dw: During a drag operation, your application changes the drop zone 
feedback to indicate a valid drop zone.—page 232 


dv: During a drag operation, your application changes the current drag 
cursor to indicate invalid drop zones. It uses the standard Common 
Desktop Environment cannot pointer.—page 232 


dz: Any cursor change or drag-over effect your application uses occurs 
within .2 seconds of the mouse pointer reaching the target area and 
does not interfere, in any noticeable way, with the interactive 
performance of the drag operation.—page 233 


tivity 

In the Common Desktop Environment, there are three operations that can 
be associated with the drag icon. These operations are explained in “Parts 
of a Drag Icon” on page 17. The drag icon has alternate graphics, supplied 
as part of the desktop, used to indicate to the user when the operation is a 
copy or link. The default operation, move, requires no alternate icon 
graphics. 
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Success or Failure 


Recommended 


Required 


The user needs an indication that the drag-and-drop operation either 
succeeded or failed. You should use transition effects to indicate the success 
or failure of the drop. 


There are two kinds of transition effects: mat and snap back. The mat 
effect is used when the user drops a drag icon on a valid drop zone. The 
effect looks like the drag icon melts into the drop zone. The drag icon goes 
away and is replaced by whatever is appropriate for the destination 
application. Dropping a drag icon on the Print Manager control on the 
Front Panel may show nothing other than the melt in effect. Dropping a 
drag icon on the File Manager control would show the melt in effect 
followed by the icon appearing in File Manager. 


The snap back effect is used when the drop fails. Drops can fail in two 
ways: because the drop zone is invalid, or because the data transfer fails. If 
the user drops a drag icon over an invalid drop zone, one that shows the 
cannot pointer drag icon, then the drag icon snaps back to the source 
application. 


Once a drop occurs, the source and destination applications have to 
transfer the data. If the data transfer fails, there are two things that the 
destination application should do. The first is to indicate to the API that 
the drop failed so that the dropped item will get snapped back to the source 
application. The second is to put up an error notice to the user that clearly 
indicates why the drop failed and what, if anything, the user can do to 
correct the situation. 


Sometimes the transition effect does not take place immediately. The icon 
appears where it is placed until the transfer is done. During this time, 
applications should set the cursor to the busy state. The icon cannot be 
moved or selected by the user until the transfer is complete; the busy 
cursor tells the user the transfer is in process. 


ea: In acollection that supports copy, move, or link operations that can be 
performed by dragging, the feedback presented to the user during the 
drag operation indicates whether a single object or multiple objects 
are being manipulated.—page 233 


eb: After a successful transfer, the data is placed in the drop zone, and 
any transfer icon used by your application is renoved.—page 233 
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Required eC: 
Required ed: 
Recommended ee: 
Required 6-17: 
Parts ofa Drag Icon 
State Indicator 


If your application removes data upon the completion of a drag and 
drop, it does so only if the drag-and-drop transfer has completed 
successfully.—page 233 


After a failed transfer, the data remains at the drag source and is not 
placed in the drop zone. Any transfer icon used by your application is 
removed.—page 234 


If the user drops an object at an inappropriate drop zone within your 
application’s window, your application participates in the display of a 
snap back effect and also posts an error dialog box indicating the 
reason the drop was disallowed.—page 234 


If your application provides any drag-and-drop help dialog boxes, they 
contain a Cancel button for canceling the drag-and-drop operation in 
progress.—page 234 


The drag icon is composed of three parts, as shown in Figure 3-5. Starting 
from the left, the drag icon is composed of the state indicator plus the 
operation indicator plus the source indicator (here shown as a folder icon). 
On the right is the composited drag icon. 


~+ a+ - a 


work 


Figure3-5 Example drag icon showing the three parts 


The state indicator is really a pointer for positioning combined with a valid 


or invalid drop zone indicator. The valid state indicator should resemble an 
arrow pointer with a hot spot so users can position the cursor in a 
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predictable manner. The invalid state indicator, a cannot pointer 
(illustrated in Figure 3-3), appears when users are over an invalid drop 
zone. 


Operation Indic ator 


The second part of the drag icon is the operation indicator. A drag operation 
can be a move, copy or link. 


move The item being dragged is moved to the destination. 
copy The item is copied to the destination. 
link A connection is retained between the destination and the 


source. This operation is defined to some extent by the 
application and is not commonly used. 


See “Actions” on page 22 to see how move, copy, and link map to user 
actions. 


The operation indicator gives the user feedback on what operation is 
occurring during the drag. Figure 3-6 shows the copy and link feedback. 
Because most drags are move operations, an operation indicator is added to 
the drag icon only for copy or link operations. 


a LS 


Figure3-6 Examples of copy (left) and link operation indicators 


Note - Operation feedback is drawn on top of the state and source 
feedback. This is basic Motif behavior. 


The user can force a drag to be a move, copy or link by pressing certain 
keys during a drag (Shift = move, Control =copy, and Shift+Control =link). 
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Required 4-36: 
Required 4-55: 
Required 4-56: 
Required 4-57: 
Recommended S: 
Recommended _ 't: 
Recommended = ui: 
Source Indicator 


The source application can also force a copy. When the user forces an 
operation, the drop zone should match that operation for the drop to 
succeed; otherwise the drop zone should indicate the operation is invalid. 


If the move, copy, or link operation the user requests is not available, 
the transfer operation fails.— page 182 


In a collection that supports selection, Shift+B Transfer Release or 
Shift+BSelect Release forces a drag move operation. If a move is not 
possible, the operation fails.—page 187 


In a collection that supports selection, Control+BTransfer Release or 
Shift+B Select Release forces a drag copy operation. If a copy is not 
possible, the operation fails.—page 187 


In a collection that supports selection, Control+Shift+BTransfer 
Release pr Shift+BSelect Release forces a drag link operation. If a 
link is not possible, the operation fails.—page 187 


In a collection that supports selection, if BTransfer Motion (or BSelect 
Motion) results in the start of a drag operation, feedback is presented 
to the user that indicates that a copy, move, or link operation is in 
progress. Whether the operation is a copy, move, or link depends on 
the type of object created at the drop zone and whether the source 
object is removed.—page 189 


In a collection that supports selection, if Control +BTransfer Motion or 
Control +BSelect Motion results in the start of a drag operation, 
feedback is presented to the user that indicates that a copy operation 
is in progress.—page 190 


In a collection that supports selection, if Control +Shift+B Transfer 
Motion or Control+Shift+BSelect Motion results in the start of a drag 
operation, feedback is presented to the user that indicates that a link 
operation is in progress.—page 190 


The source indicator is a representation of the selection (or the thing being 
dragged). It comes in several versions depending upon whether the 
selection represents single or multiple items and what kind of thing the 
selection is representing. Table 3-1 shows examples of drag icons. 
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Note - Since the drag icons are dynamically composited as cursors, screen 
shots cannot be taken; therefore, Table 3-1 is an approximation of what is 
seen on the screen and may not be completely accurate. 


The hot spot is located on the top left corner (1,1) for the text drag icons. 
The hot spot for the single and multiple drag icons is located at the top left 
pixel of the invalid icon (3,3). Each drag icon has been tuned to increase 
user accuracy at targeting and positioning. 
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Table 3-1 The possible drag icons shown with generic source indicators. 


Text Single Multiple 
Operation Selection Selection Selection 
Valid Move 
Valid Copy 
Fi: bs 
Valid Link 
Invalid Move 
None bs 
[q Q| 
Invalid Copy 
Invalid Link 
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Drag-and-Drop Mechanics 
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Types 


Actions 


There are several areas of the underlying application architecture that are 
useful to understand when designing drag and drop. 


© What type of object is being dragged. 
® What action takes place when the object is dropped. 


© How to match operations between source and destination applications. 


In the Common Desktop Environment, there are three types of draggable 
objects: files, buffers, and text selections. 


Each application has its own objects that can be dragged and dropped. F or 
example, Calendar uses appointments, Mailer uses mail messages, and File 
Manager uses folders and files. The folder and file icons in File Manager 
exist as separate entities in the underlying file system and are, therefore, 
treated as files when dragged and dropped. However, Calendar 
appointments and Mailer messages do not exist as separate entities in the 
file system. When these objects get dragged they are treated as buffers. 


This difference can lead to some conflicts for the user. The user sees both of 
these types of objects as the same—both can appear as icons and both can 
be manipulated separately from other similar objects. Yet, due to the 
implementation, the user may see different results from a drag-and-drop 
operation based on which type of object is being manipulated. 


Text selections fall into a different category because selecting a piece of text 
is very different to the user than selecting an icon. The user selects a range 
of text in a document window; the text does not represent the whole 
document, it only represents a piece of a document. Rarely does a user see 
the piece of text as a distinct object and the user does not expect a piece of 
text to behave like an icon when dropped. For this reason, the drag-and- 
drop model for text mirrors the cut, copy, and paste operations available 
from the Edit menu. 


There are two actions that can take place when an object is dropped: insert 
or load. 
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The insert action inserts the dropped object into the destination, adding it 
to the current data in the application or document. The object is inserted 
when a user schedules an appointment, prints a document, attaches a 
document, pastes text, or appends a mail message. Such an action is a 
move or copy operation depending on the destination and the user. The user 
might decide to copy a piece of selected text, as opposed to moving it. The 
drag icon should indicate whether the operation is a copy or move. 


The load action operates the same as if the user had chosen Open from the 
File menu, selected a file, and clicked the Open button. The dropped object 
gets loaded into the application. The user can edit it and save changes back 
to the original file. Load only works with files at this time, not with buffers 
or text. The user should see the copy drag icon when dragging an object 
over a drop zone that supports the load action. 


Load does work with buffers; however, buffers are loaded as read-only. See 
the section on “Attachment User Model” for more details. 


Matc hing Operations 


When designing how drag and drop works in an application, you must 
understand how Motif figures out what operation gets done when the 
source and destination of a drag and drop don't match. 


For each drag source, an application advertises which drag-and-drop 
operations are possible and on what destinations it can be dropped. For 
each drag destination, the application advertises the possible sources and 
the types of operations. If a source and its destination have two or more 
operations in common, Motif follows a specific order to determine which 
operation to use. That order is move, copy, link. The application cannot 
change the operation that is accepted based on the type of thing being 
dragged. 


For example, application A might advertise that an element can be moved 
or copied. Application B advertises that the destination accepts copy or 
link. The intersection in this example is copy. If the destination in 
application B accepts move or copy, then the source is moved because the 
move operation comes first in the operation order. 
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In this example, the user could override the move operation by holding 
down a modifier key, for example the Control key to make the operation a 
copy. This will work if the copy operation is in the common set of 
operations. If the copy operation is not in the common set, then the drag 
becomes an invalid drag. 


The only time matching operations may be a consideration is when you 
have a destination that could accept moves but prefers copies. In that case, 
the destination is better off only accepting copies. 


It is wise to always accept copy. Accepting copy broadens the scope of 
acceptable drops. |n most cases where a move is accepted, a copy would 
work just as well. Remember, move is implemented as a copy followed by a 
delete. 


Determnining Drag Sources 


Required 


When you decide to use drag and drop in an application, you must decide 
what control elements can be dragged and how that element is to be 
represented. Typically, the user selects something like text or a file to drag, 
but the application may have other elements for which drag and drop may 
make sense, such as mail messages or appointments. 


This section provides general guidelines for determining drag sources and 
then talks about specific elements that can be dragged. 


Note - Drags are only sourced from human interface elements that have 
selectable components or items. Drags cannot be sourced from static labels 
like those on buttons or menus. 


Before you decide on a drag source from your application, you must 
consider how the drag is to be integrated into the selection mechanism of 
your application. The user must be able to select or drag without any 
confusion as to the result of that action. 


4-58: When a drag move operation moves a selection within the same 
component, the selection moves along with the elements 
selected.—_page 187 


In other words, when selected elements are moved with a drag 
operation, they should stay selected after the move. 
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Required 


Required 


Required 


Required 


Required 


4-59: In text-like collections, initiating a drag within a selected region 
drags the entire text selection.—page 187 


4-60: | n list-like and graphics-like collections, initiating a drag with either 
BSelect or BTransfer on a selected element drags the entire 
selection.—page 188 


4-61: |n list-like and graphics-like collections, initiating a drag with 
BTransfer or BSelect on an unselected element drags just that 
element and leaves the selection unaffected.—page 188 


4-62: When a drag is initiated in an unselected region and the pointer is 
over two possible draggable elements, the drag uses the draggable 
element highest in the stacking order.—page 188 


4-67: When BTransfer (or BSelect) is released, the drop operation 
ordinarily occurs at the location of the hot spot of the drag icon 
pointer and into the highest drop zone in the stacking order. However, 
if a drop occurs within a selection and pending delete is enabled, the 
transferred data replaces the contents of the entire 
selection.—page 189 


Sc rolling Lists 


In the Common Desktop Environment, items in a scrolling list are text 
objects by default. They can be buffer objects, but they cannot be both text 
and buffers. For example, the Calendar Appointment Editor has a scrolling 
list of appointments that the user can select and drag. When the user drags 
an appointment, they are manipulating a buffer and the drag icon shows an 
appointment icon as the source indicator, as shown in Figure 3-7. A Mailer 
container window has a list of mail messages in the upper portion of the 
window. Users can select and drag one or more messages from this list. 
These messages are actually buffers and the drag icon shows a mail 
message as the source indicator. If multiple mail messages are dragged, 
then the drag icon shows the multiple source indicator. 
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Required 


Required 


10:00 No Meetings 
1:00 Meet w/Dave 
2:00 Meet w/Frank/Karen 


Figure3-7 Example of a scrolling list with an item selected for dragging 


If your application uses a scrolling list to show mail message headers or list 
other kinds of objects, then you need to integrate dragging with extended 
selection. this behavior can be seen in the Mailer application. 


k: 


In a collection that uses range selection, pressing BSelect on an 
unselected element sets an anchor on the element, or at the position 
where BSelect was pressed, and deselects all elements in the 
collection. If BSelect is released before the drag threshold has been 
exceeded, then the element under the pointer should be selected. If 
BSelect Motion exceeds the drag threshold, then a new selection 
should begin. The anchor and the current position of the pointer 
determine the current range. As BSelect is dragged through the 
collection, the current range is highlighted. When BSelect is released, 
the anchor does not move, and all the elements within the current 
range are selected.—_page 172 


In a collection that uses range selection, pressing BSelect on an 
currently selected element should not cause all other elements in the 
selection set to be deselected. If BSelect is released before the drag 
threshold is exceeded, then, at that point, all other elements should 
be deselected and the element under the pointer should remain 
selected. If BSelect Motion exceeds the drag threshold, then no 
element should be deselected and a drag operation should 
begin.—page 172 
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Dialog Boxes 


Sometimes an application needs to be able to drag from inside a dialog box. 
For example, in the Calendar Appointment Editor, there are a series of text 
fields on the left side where the user enters information about an 
appointment. Allowing drags from this area lets the user drag text from the 
appointment description. 


Calendar Appointment Editor 


Time What 
10/17/1 994] 10:00 No Meetings 
1:00 Meet w/Dave 
 g:8 9:00 = | AM PM 2:00 Meet w/Frank/Karen 
10:00 10:00 = | ( AM _)PM 
ik: 
— Drag Appt 


Insert | Change Delete Clear Cancel Help 


Figure3-8 Example Calendar Appointment Editor dialog box 


The recommended method for indicating that something can be dragged is 
to include an icon graphic in the dialog box. The icon graphic should be 
draggable. This icon graphic must be the same icon used to represent the 
data in File Manager. In Calendar, the appointment icon is shown just as it 
would appear in File Manager (see Figure 3-8), with a label under it. This 
is the same icon used in the drag icon source indicator. 
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Recommended 


Windows 


Place the icon graphic in the dialog box adjacent to the information to be 

dragged. The upper right corner of the dialog box or window is the default 
position, but it can be changed depending on the application. |n Calendar 
Appointment Editor, the icon is placed near the main text field to indicate 
that you can drag the text fields. 


ds: Usean icon graphic in a dialog box or window to indicate that objects 
within the dialog box or window can be dragged. Use the same icon 
graphic used to represent the draggable object in File Manager. Place 
the icon adjacent to any display of the contents of the object, if such 
display exists. If there is no such display, place the icon in the upper 
right corner of the dialog box or window, unless a more suitable 
placement is determined. The icon should be 32x32 in size and havea 
label under it. The label should indicate what kind of object the icon 
graphic represents. The icon graphic should also be used as the source 
indicator in the drag icon.—page 231 


In some applications, you may want to allow the user to drag the entire 
document or file. For example, in | con Editor, it might make sense to allow 
the user to drag the file for the icon currently in the editor. The application 
should indicate to the user that the document or file can be dragged by 
incorporating an icon graphic in the window of the application. The icon 
graphic should be draggable. In the case of Icon Editor, one of the icons 
used for displaying the contents of the icon file could be used for the drag. 
The icon should follow the guidelines for an icon used in dialog boxes; that 
is, it should be the same icon used to represent the document in File 
Manager, be 32x32 pixels, have a label, be placed adjacent to the data being 
dragged, and be used as the source indicator in the drag icon. 


Dragging and Dropping a Multiple Selection 


28 


When the user selects more than one item to be dragged, the drag icon 
should change to indicate there is more than one item selected. 


Some drop zones may be able to accept only a single item. It is not possible 
for a drop zone to differentiate between a single and a multiple set of items 
being dropped. The drop icon does not display the cannot pointer; instead 
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the items should melt in and then be snapped back by the destination 
application. The snap back should be followed by an error notice that tells 
the user why the drop failed. 


Recommended ef: Applications that accept only single items should reject all multiple 
item drops.—page 234 


There is no consistent method to determine which of the selected 
items the user really wants to drop. 


Standard Supported Drop Zones 


The standard supported drop zones in the Common Desktop Environment 
are Front Panel controls, open windows, and folder, action, and certain 
other icons in File Manager. Dropping on minimized icons and on File 
Manager icons that do not support drops are not supported in the Common 
Desktop Environment. 


The Front Panel 


The Front Panel is a collection of controls and other functions put together 
for easier and faster access for users. As a consequence, its drag and drop 
behaviors are heavily dependent upon the context of the destination. F or 
example, if the destination is a printer, then print it. If the destination is a 
subpanel, then install it. Most applications will not vary in behavior quite 
as broadly as the Front Panel. 


File Manager 


File Manager for the Common Desktop Environment allows users to drop 
icons on the desktop. The icon on the desktop becomes a reference. The 
creation of the reference and resulting behaviors are not consistent with 
the future user model for the Common Desktop Environment. Until the 
user model and architecture are further specified, developers are not 
encouraged to do any drops onto the desktop or to copy the File Manager 
behavior. 


Within File Manager windows, File Manager allows dropping onto icons 
other than folders and action icons for the Common Desktop Environment 
1.0. For example, dropping a mail message icon onto a mail container icon 
appends the mail message. 
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When mail messages or calendar appointments, or other buffers are 
dragged from the source application and dropped onto File Manager, they 
must be named. The underlying API supports a name field for the item 
being dragged. This name should be used as the name of the buffer. The 
name should be determined in a manner consistent with the application 
from where it came. If there is no appropriate name, as in dropping a text 
selection in File Manager, File Manager should name the resulting file 
“unnamed”. If there is a name conflict, File Manager should put up a dialog 
box and ask the user to rename the dropped file. 


No Drop-Only Targets 


Mouse Button Usage 


Required 


The Common Desktop Environment does not support the concept of a 
specific control or graphical target used only for drops. Any control in the 
human interface that has selectable items can be dropped upon and should 
provide drop zone feedback. This includes data panes, scrolling lists, and 
text entry fields. The operation that takes place upon the drop should be 
consistent with the users expectations for that application type. 


In the Common Desktop Environment, the user can modify mouse 
mappings to accommodate different working styles. BSelect has been 
modified to support drag and drop in addition to BTransfer, which has been 
used historically for Transfer operations in Motif. 


Users can set up their systems to use Bselect or BTransfer to perform drag 
and drops, or use BSelect only. Consider this when you design your 
application. Check how the user has set the mouse button mappings and 
use those mappings. 


p: Your application supports the use of mouse button 1 to perform drag- 
and-drop operations.—page 183 


In Motif 1.2, drag and drop is typically performed using button 2 on a 
three-button mouse (BTransfer). However, in the Common Desktop 
Environment environment, mouse button 1 (BSelect) should be 
supported for drag and drop to support mouse usage compatible with 
other graphical user interface (GUI) environments. A drag can be 
initiated with either mouse button 1 or mouse button 2. 
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Required 


Required 


Placementupon Drop 


q: When button 2 of a three-button mouse is configured to operate as 
BAdjust, your application does not perform any BTransfer operations 
when clicking mouse button 2.—page 183 


On a three-button mouse, button 2 is typically used for the BTransfer 
function. However, in a Common Desktop Environment environment, 
the user may change an environment setting indicating that mouse 
button 2 should be used for the BAdjust function instead. BAdjust can 
be used to extend the selection set in the same manner as 

Shift+B Select. 


r: BSelect should always initiate a drag if the drag is started on a 
selected item. The drag starts once the drag threshold has been 
reached. This is true for text regions, scrolling lists, and other similar 
elements.—page 183 


From the user’s point of view, the placement of the dropped item is 
dependent on the task the user is doing and the application or context the 
task is in. 


In File Manager, if the default is set to As Placed, then icons are placed 
where they are dropped. If the default is set to Sorted Grid, then a dropped 
icon is automatically sorted and then placed, which means it may not be 
placed where the user drops it. 


In some cases, where the dropped item gets placed is not a criteria. For 
example, Front Pane! controls require only that the dragged item be over 
the control to activate the drop zone. 


In the Compose window in Mailer, the placement depends on what is being 
dropped. If the user is dragging a piece of text, then the text is inserted at 
the drop point. From user testing, this is what users expect. If the user 
drops an icon, a file or a buffer, then the contents are included at the 
insertion point. This mirrors the behavior the user gets when the user 
selects a file from the Include File Selection Box. 


You should determine appropriate behavior for your application based on 
what type of tasks the user is doing. 
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Ending a Drag 


Required 


Required 


Required 


4-37: |f a collection does not have a fixed insertion point or keep elements 
ordered in a specific way, the insertion position for transferred data is 
determined as follows:—page 182 


* For BTransfer-based (or BSelect) primary and drag transfer 
operations, excepted as noted below for text collections, the 
insertion position is the position at which the user releases 
BTransfer (or BSelect). 


* Ina text-like collection, when the user drops selected text, the 
insertion position is the position at which the user releases 
BTransfer (or Bselect). When the user drops an icon, the insertion 
position is the text cursor and the data is pasted before it. 


* Ina list-like collection, the insertion position for other transfer 
operations is the element with the location cursor, and the data is 
pasted before it. 


The insertion position is the position in the destination where 
transferred data is placed. Some mouse-based transfer operations 
place data at the pointer position if possible. Other operations, 
including keyboard-based transfer, generally place the data at the 
location cursor. 


The following two items allow users to stop a drag operation without any 
data loss or other negative result. 


dx: Pressing Cancel ends a drag-and-drop operation by canceling the drag 
in progress.—page 233 


dy: Releasing BTransfer (or BSelect) when not over a drop target ends a 
drag-and-drop operation.—page 233 


Performance Guidelines 
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There are several points during a drag-and-drop operation that the timing 
and response to the user is critical. The responsibility for ensuring optimal 
performance belongs to the source and destination applications, as well as 
the Motif Drag-and-Drop API and Drag-and-Drop Convenience API. 
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The following time line explains the individual user steps and system 
responses in a drag-and-drop operation. The suggested guideline for 
interaction timing is noted after the relevant step. 


1. 


The user makes a selection. The pointer is over the selected object. The 
user presses and holds down the mouse button. 


. The user starts to move the pointer. The user should be able to move the 


pointer 10 pixels before a drag is initiated. If the user is pressing 
BTransfer, there is no drag threshold. 


= The pointer changes to a drag icon when the drag is initiated. 


Movement Latency: The latency from hand movement to drag icon 
display should be less than 50 msec. with a maximum limit of 70 msec. 


. The user drags over a drop zone, crossing the boundary line with the hot 


spot on the drag icon. 


= The drag icon changes to the cannot pointer if it is not over a valid 
drop zone. The drop zone becomes highlighted if it is a valid drop zone. 


Movement Latency: The latency from hand movement to drag icon 
display should be less than 50 msec. with a maximum limit of 70 msec. 


. The user drops the drag icon on the drop zone. 


= Ifthe drop zone is not valid, the drag icon is snapped back to the 
source using the snap back transition effect. 


= If the drop zone is valid, the drag icon is melted into the destination 
using the melt in transition effect. 


Echo Latency: The display latency from mouse button release to 
feedback echo should be less than 50 msec. with a maximum limit of 120 
msec. 


Snappy Transitions: Transitional animations should run from 200 to 
350 msec. with a maximum limit of 500 msec. The animation should run 
at the same speed regardless of hardware conditions. 
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5. The destination application starts the data transfer. 


= A message is displayed to the user indicating data transfer has 
started. 


= Progress is indicated by further messages. 
= The completion of the data transfer is indicated to the user. 


= If the data transfer fails, it is up to the destination application to 
provide the user with appropriate feedback as to why it failed. 


Command Latency: The latency from command invocation (drop 
occurred) to completion should be in the range of 0.3 to 1 second with a 
maximum of 2 seconds. 


Busy Feedback: When a command may run longer than 2 seconds, 
display a busy cursor whenever the cursor is over the busy object. When 
possible, display partial results. The progress indicator or busy cursor 
should be displayed in less than 0.5 second. 


Progress Indicators: A status message or an |n Progress *messagebox* 
should be displayed upon completion of the transitional animation 
indicating the data transfer is taking place. For example: Data 
transfer is 10% complete. ThiS message can then be updated every 
2 to 3 seconds until the transfer is 100% complete. 


Notice: |f the data transfer fails, a message should appear, either in the 
status area or in an In Progress *messagebox*, indicating why the drop 
failed and what the user can do about it, if anything. 


Using Attachments in Your Application 


This section discusses the user model and guidelines for attaching 
documents to documents in the Common Desktop Environment 1.0. This 
functionality can be seen in the Mailer software application. If you plan to 
include an attachment list in the interface of your application, then you 
should read this section. 


Note - This set of guidelines is not a description of an embedded document 
architecture. 
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For the Common Desktop Environment, attachment and attachment list 
are defined as follows: 


attachment Suppose you had two documents called A and B. If a 
document, A, is attached to another document, B, then 
A continues to exist as a separate document that is 
“carried” by B. A is shown as an icon within B. A can 
be opened and viewed independently and can be 
detached from B at a later time, as if never attached 
at all. 


attachment list = The area in which attachments are displayed. Should 
be scrollable and include room for showing icon labels. 


Note - Users do not think of a document that has several attached 
documents as a container. Containers are an implementation concept that 
should not appear in the attachments human interface. For that purpose, 
the term container should not be used to describe attachments to the user. 
(It may be an appropriate term elsewhere.) 


Attachment User Model 


Attachments are shown as icons where they are attached. These icons are 
the same icons as those used in File Manager and other places in the 
Common Desktop Environment. The basic rule of behavior is that if the 
same icon is used in File Manager as in an attachment, then every effort 
should be made to make the two behave the same in every situation. 


There are three levels of functionality for attached documents: 
1. Ability to attach and detach documents 


2. Ability to open, view, and quit an attached document in a separate 
window 


3. Ability to edit the attachment in a separate window and save changes 
back to the attached document 


The goal is to provide Level 3 functionality whenever possible. If an 
attachment cannot provide this level, then it should degrade its level of 
functionality in the steps shown. This section is written assuming Level 3 
functionality. 
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If a document provides significantly different functionality as an 
attachment from that provided as a File Manager icon, then provide a 
different icon for the attachment to clearly indicate to the user the 
difference in functionality. 


Attac hment Functionality 


Recommended 


Recommended 


Recommended 


To incorporate attachments into an application, several issues should be 
considered. 


WhatCan Be Attached? 


You should determine for each application what items it can attach. For 
example, Mailer can attach documents, scripts, and applications, but not 
folders. 


Whatis the Method for Attac hing? 


There are two methods of attachment, through the file selection dialog box 
that comes up when you choose Add File from the Attachment menu, and 
through drag and drop from File Manager or another application. 


eh: Drag and drop should not be the only method for attaching 
objects.— page 235 


el: When the user chooses something to attach from the file selection 
dialog box that is not an attachable item, then the user receives an 
error message explaining why the chosen item cannot be attached. 
For example:—page 235 


The folder “My.Stuff” cannot be attached because it is a folder. 
Only documents, applications, and scripts can be attached. 


ej: When the user attempts to drop something into the attachment list 
that is not attachable, then the drop fails and the item is snapped 
back to its source.—page 235 
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What Happens When Something Is Attac hed? 


The act of attaching document A to document B copies the bits of document 
A into document B. There is no further connection with the original file. If 
the user opens the attached document and makes changes, the changes are 
saved back to the attached document only, not back to a file in the file 
system. 


Attachments in Attachments 


Users can attach messages or text files that have attachments inside them. 
This is sometimes referred to as “nesting”. The user reading the text file 
would perhaps see a mail message icon that the user could then open, 
which may have a text message and more attachments. 


Editing and Saving Attachments 


Recommended 


Recommended 


The user should be able to open an attachment, edit it, and save the 
changes back to the attachment. I f the attachment does not have the ability 
to do this, then the Open action should not appear in the Actions portion of 
the menu when that attachment is selected and double-clicking should not 
open the attachment. 


ei: Double-clicking is a shortcut for selecting the attachment and 
choosing the Open menu item for attachments and should never be 
the only way to access attachments.— page 235 


ek: When the user has one or more attachments open for editing and 
attempts to do any operation that would result in potentially losing 
the user’s edits, the user should be clearly warned and given the 
opportunity to save changes.—page 235 


Exec uting Attachments 


If the user tries to open or double-click on an executable attachment, then 
there may be times when the user should be asked to confirm this 
operation. Both the name of the attachment and the name of the action 
being taken on the attachment should be variables. An example error 
message follows: 


“Invitation” is an executable attachment. Do you want to Run it? 
Buttons: Run, Cancel, Help 
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Read-Only Attachments 


Read-only attachments can be opened for reading only. This state should be 
indicated to the user by inactivating the menus in the attachment 
application, inactivating the selection cursor, or some other obvious 
method. At a minimum, the Save menu item in the attachment application 
should be dimmed. 


Drag Load and Attachments 


Drag load can be accomplished in two ways. In applications that directly 
support drag load, users can drag an icon, from File Manager, over the open 
window for that application and drop it which loads the file represented by 
that icon. The same result can be accomplished by dropping an icon onto an 
action icon. The action starts an editor, which then loads the file 
represented by the icon. When an icon from File Manager is drag loaded, it 
is equivalent to choosing Open from the File menu. The open file can be 
edited and saved. 


In the case of attachments, users can drag and drop an attachment onto 
editors or actions that support drag load but any edits made are not saved 
back to the attachment. Attachments, which are implemented as buffers, 
are loaded as read only data. 


When the user tries to save changes to a loaded attachment, the editor 
displays a file selection dialog box and asks the user to confirm the name 
and to choose a place in the file system to save the file. The name used in 
the file selection dialog box is the same as the attachment name. If the 
editor (command line application) cannot bring up a file selection dialog 
box, then it should clearly and visibly indicate to the user that the loaded 
file is read-only. 


If the user wants to edit the attachment directly, the user must select the 
attachment in the attachment list, choose Open from the Attachment menu 
or double-click on the attachment. This opens the attachment in a manner 
that allows for editing and saving changes. 


Another option is to drag load an attachment, edit it, save it to a new file 
name, and replace the old attachment with the new one manually. 
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Attachment Menu Contents 


Recommended bw: If your application uses an attachment menu, it contains the 
following choices, with the specified functionality, when the actions 
are actually supported by your application.—page 215 


Recommended Add File... | Selects files and other items to be attached. A file 
selection box is displayed allowing the user to select 
the desired files to attach. The default button in the 
file selection box is Attach.—page 215 


Recommended Save As... Saves the currently selected attachments. The user is 
prompted with a file selection dialog box for indicating 
where in the file system the attachments are to be 
saved. When multiple attachments are selected, the 
name field is inactive and the current names of the 
attachments are used as the name of the new file. This 
menu item is active only when one or more 
attachments are selected.—page 216 


Recommended Rename... Renames the attachment icon. The application should 
provide in-line renaming of attachment icons, such as 
File Manager uses. If the application cannot provide 
in-line renaming, then Rename allows the user to 
rename an attachment by displaying a dialog box, 
requesting the name from the user. This menu item is 
active only when a single attachment is selected. It is 
not active when multiple attachments are 
selected.—page 216 


Recommended Delete Deletes attachments from the attachment list. This 
menu item is active only when an attachment is 
selected.—page 216 


Recommended Select All Selects all the attachments in the attachment 
list.—page 216 
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Color Philosophy 


Visual Design 4 


The Common Desktop Environment is a visually rich environment. This 
chapter provides information on designing icons and other visuals 
consistent with the desktop style. It discusses some of the design 
philosophy behind the desktop, and some useful hints to help you 
successfully create icons in the desktop. 


Icons are graphics that represent the objects (that is, applications, files, 
and devices) present in a graphical user interface (GUI). Fitting your 
application into the desktop means designing icons to represent your 
application and the data files it creates. These icons should be created in 
several sizes and color depths. 


This chapter discusses the desktop components where icons are used, the 
requirements of the environment, and discusses the design process. A 
series of examples have been provided that may parallel your own 
implementation situation. 


In most other GUIs, the color is applied in a localized and specific sense, 
either in individual icons or specific control areas, such as window borders 
or title bars. In the desktop, color is pervasive, as virtually everything is 
drawn with colors, with a notable absence of black lines. 
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Whatisan Icon? 


Most of the icons in this environment use color sparingly, preferring grays 
instead. This limited use of colors keeps the number of colors used from the 
palette in the desktop to a minimum and works well visually. Because the 
icons, being largely colorless, always appear in the context of colored 
backgrounds, they stand out more. 


An icon can be defined as a specific graphical element, one that can be 
moved, copied, deleted, opened, and so on, usually through direct 
manipulation. 


Numerous graphical elements in the desktop are not manipulable and, 
therefore, not technically icons, but may still be needed in your application. 


This book discusses the entire range of graphical elements you may need to 
provide. 
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Figure4-1 Screen shot of the desktop environment 
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Icons can serve to: 


Identify data and application objects 

Facilitate direct manipulation of objects 

Indicate an object’s state (selected, and others) 

Convey a recognizable product identity 

Show the relationships between the objects of a product 


All of these purposes for an icon serve as guidelines for designing icons. 
The visual designer has more responsibility for some of these requirements 
than for others. For example, the direct manipulation of objects and the 
indication of an object's state and location are done by the desktop system, 
while identifying and conveying product identity and object relationships 
fall mainly under the responsibility of the visual designer. 


Recommended ey: Icons should be used to represent only objects and 
applications.—page 238 


Icons provide a visual representation for objects and facilitate direct 
manipulation. If icons are used for other purposes (for example, as 
illustrations) where the user can’t drag them, select them, and so on, 
it creates a confusing inconsistency. 


Applying a set of design guidelines, like the ones here, should be considered 
during icon design. A new product on the user’s desktop means adding a 
new set of icons to the ones already present. Conforming to these guidelines 
ensures the new icons do not clash with the user’s expectations. 


Icon-Centriic Components 


File Manager 


File Manager is the tool that provides for the presentation and organization 
of the user’s file structure. The basic types of iconic objects displayed in File 
Manager are files, directories (folders), executables and actions. In this 
chapter, these objects are referred to as documents, folders, and 
applications. File Manager displays the icons in two sizes, called Icon and 
Small Icon views in the Set View Properties dialog box. Icon is size 32x32 
and Small Icon is size 16x16. 
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Figure4-2 Collection of icons at sizes 32x32 and 16x16 as used in File Manager 


Documents, folders, and applications are represented by three different 
shapes. Documents are vertical rectangles meant to look like pieces of 
paper. Folders are horizontal rectangles with a tab to look like a file folder. 
Applications can be any shape and use the entire icon square. All objects in 
File Manager should indicate to the user that they can be manipulated, 
that is, dragged and dropped. 
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Application Manager 


This window is similar to File Manager, but its focus is on holding 
applications rather than documents. All network-accessible applications in 
the desktop are placed here in containers, called application groups, rather 
than folders. 


Application Manager is like a “network store.” This is the place users go to 
find the latest applications available on their system. 


7, x a) Bl 
Desktop_Apps Desktop_Tools Information System_Admin 


Figure4-3 Examples of application group icons from Application Manager 


Application group icons, as illustrated in Figure 4-3, are like folders in that 
they represent a collection of objects, in this case related objects. If your 
application requires support files or comes with sample files, for example, 
you can design your own application group icon that represents where a 
user can get the related files for your application. 


Front Panel and Subpanels 


The Front Panel is the “control” panel for the desktop and usually appears 
at the bottom of the screen. Front Panel icons provide quick access to the 
user's most commonly used applications. 
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Figure4-4 Partial screen shot of Front Panel with the Personal Applications 
subpanel open 


The Front Panel also has subpanels of icons that can be accessed through 
the arrow buttons on the Front Panel. The concept of the subpanel is that it 
is an extension of that Front Panel! icon. For example, Figure 3-4 shows the 
Personal Applications subpanel open. Users can add applications to this 
subpanel by dropping them on the Install drop site. Users can choose to 
promote icons in the subpanel to the Front Panel via the pop-up menu. 


Minimized Window Icons 


Minimized window icons appear on the desktop when a window is 
minimized. The icon should represent the application that controls the 
minimized window (see Figure 4-5). These icons are different from the icons 
used in the Front Panel in that they represent running applications, 
although they are the same size. 
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Figure4-5 Minimized window icons for Terminal, Text Editor, Calendar, and File 
Manager 


OtherGraphics 


The dominant elements in this category include button graphics, tool bar 
graphics (see figure below), and graphics used as labels. A tool palette ina 
paint program is one example. A document orientation button (landscape or 
portrait) in a printer dialog box is another. These are graphics that you 
create for use in your application and are not used elsewhere. 
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Figure4-6 Example of a tool bar used in the Calendar application 
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Color Usage in Icons 


When designing icons for a desktop application, you must be aware of the 
available color palette and the dynamic mapping of colors. 


Icon ColorPalette 


Recommended 


Theiconsin thedesktop usea palette of 22 colors: 
¢ Eight static grays 
¢ Eight static colors: white, black, red, blue, green, cyan, magenta, and 
yellow 
¢ Five dynamic colors: Foreground, Background, TopShadow, 
BottomShadow, and Select 
¢ A transparent “color” which allows the background to show through 


These colors are the default colors in the Icon Editor, which is the 
recommended tool for creating desktop icons (See Figure 4-7). This set of 
colors provides a reasonable palette with which to create icons. This limited 
palette was chosen to maximize the attractiveness and readability of icons 
without using an unnecessary number of colors. 


If you use colors other than the ones listed here, then your icons may 
experience color flashing effects that can make the icon unreadable. The 
best way to ensure predictability of appearance of your icons is to use only 
the 22 colors in the desktop palette. 


ez: Icons should use only the palette of 22 colors.—page 238 
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Figure4-7 Icon Editor, showing the 22 Common Desktop Environment colors 
available for icons 


Dynamic Colors 


It is important to understand the limited role of the dynamic colors. These 
represent the colors used to display the user interface elements on which 
your icon appears. If your icon appears in File Manager, File Manager 
determines what the background color is. If the user changes the color 
palette in Style Manager, the colors in the user interface change to match, 
and the background color the icons are displayed on changes. 
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In general, these colors have little use in most icons. There are two ways 
they are used: 


© If your icon does not fill the entire bounding box, then fill the unused 
area with the transparent color. 

* You can draw a shadow under your icon. This is only recommended for 
Front-Panel-style icons. Do not use this for File Manager icons. See 
“Optional Front Panel Icon Style” on page 63 for more detail. 


Figure4-8 Example of dynamic color shadows 


Design Philosophy and Helpful Hints 


The visual designer must approach the design of icons both individually 
and globally. Each icon should be individually designed according to the 
metaphor for that object. Pay careful attention to the visual effect produced 
by the entire set of icons for an application; they should work together as a 
family of icons. 


Icon design is an iterative process. It is useful to save as many of the 
iterations as possible whether they are done on paper or computer. When 
icons are tested with users, it helps to have a varied set of choices to work 
with. 
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The philosophy behind the graphic language of the desktop is that users 
benefit if the computer world more closely resembles the real world. This 
extends from the three-dimensional appearance of windows and controls, 
such as push buttons and menu bars, to the general appearance of icons. 


Your application icon can range from a logo to an object like the paint 
bucket in Figure 4-12 on page 53. An icon that looks “real” looks more like 
something that can be dragged and dropped and manipulated in other 
ways. 


Designing with Color 


Icon Styles 


Your icon should primarily use the eight static grays with the eight static 
colors used mostly as accents. The eight static colors are very strong and 
can easily be overused. Using mostly the static grays allows icons to blend 
gracefully with the already colorful desktop environment. The static colors 
can be dithered with the static grays to tone the colors down for coverage of 
larger areas. The grays can also be used to smooth the edges of icons, this 
is sometimes referred to as “anti-aliasing”. 


It is recommended not to use the dynamic colors in File Manager icons, 
because the appearance of the icon will change when the user changes color 
palettes. Such a change could be inappropriate as well as unpredictably 
ugly. 


Icons run the gamut of graphical styles. From the earliest GUI days, the 
favorite has been a simple black outline style. As color has been added, the 
style has been that of coloring books, adding color within the black lines. 
This is a natural drawing style, especially when done on white 
backgrounds. Many icons are pictographic, while others are abstract. 


Figure4-9 Calendar icon in black and white outline style on left and the desktop 
gray style on right 
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The desktop, with its pervasive use of colored and medium-value 
backgrounds, uses both lighter and darker shades to create fairly realistic 
images. You are encouraged to explore this rendered style. 


Figure 4-10 Examples of three-dimensional icons in the desktop 


Another element of style is the point of view taken in portraying the object. 
The Common Desktop Environment uses a head on view, as can be seen in 
Figure 4-10, usually from slightly above if the object in question is a three 
dimensional one, such as a printer. It is best to use a treatment that gives 
the icon a slight dimensional quality, as this reinforces the perception that 
the icon can be dragged and dropped. 


XI'M treatment XEM treatment 


Figure 4-11 Outline style converted to Common Desktop Environment style, in XPM 
and XBM formats 


Designing Your Application Icon 


The application icon is the most important icon for you to design. This is 
the place for your product identity, as well as a clear indication to the user 
of what your application does. The application icon is what the user opens 
to run your application. 
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There are no shape conventions for application icons. They can fill the 
entire icon bounding box or they can be irregular in shape. It is 
recommended that your icon have a three-dimensional style to it. The icons 
shown in Figure 4-12 on page 53 are application icons used in the desktop 
that you can also use as templates when designing your own icons. 


Figure 4-12 Examples of application icons used in the desktop 


Designing Your Application Group Icon 


The application group icon represents the container in which users find 
your application, as well as any other files you may choose to include, such 
as ReadMe or sample files. Design the icon in such a way that users know 
it is a container, such as a folder or box. 


Figure 4-13 Examples of application group icons 


The concept used in Application Manager is that of an icon based on 
accordion-style folders, as seen in Figure 4-13. This icon is large enough 
that images can be stamped on the front of it to indicate to the user what 
kind of things can be found inside. 
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Designing Your Doc umenticons 


A document icon should help the user understand what kind of data is 
stored in that document icon and what application is associated with the 
document. Figure 4-14 shows a number of document icons used in the 
desktop that you can use as templates when designing your own document 
icons. 
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Figure 4-14E xamples of document icons used in the desktop 


Applications that support multiple file formats need different document 
icons for the different output formats. Rather than creating a distinctively 
different graphic for each format, you might use the same graphic for the 
basic file and add a “tag” to delineate the format. 


In the case of the document icon, the basic rectangle of the document is left- 
aligned in the icon square. If the tag approach is used, place the tag on the 
right side of theicon, half on and half off the basic icon, but not obliterating 
the descriptive graphic, as illustrated in Figure 4-14. 


Intemational Ic ons 


If your program will be used in more than one country, you should either 
design your icons for worldwide use or create separate icons for each 
country. 
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Recommended 


Worldwide icons are ones that are universally understood. For example, a 
document icon can be understood around the world because it represents 
paper, which is used everywhere. Icons for things like a mailbox or trash 
can are not universal because these objects look different in different 
countries. 


Humor usually does not translate well. Text and symbols are also country- 
specific and should not be used in icons. Avoid the use of animals or body 
parts (heads, hands, and so on) because these have varying meanings and 
may be offensive in some cultures. 


fa: Icons should be designed for international use.—page 238 


Differences with Other Platfoms 


The desktop is different from the application spaces you may be familiar 
with in the following ways: 


¢ The desktop requires the larger 48x48 size to accommodate higher 
resolution displays. 


® The desktop has a different color space for icons. You may be able to 
reuse icons from other environments, but if they have color in them, 
chances are some of the colors will need to be changed to map onto the 
desktop palette. The basic design should still work. See Table 4-1 for aid 
in translating colors. 


© Perhaps the most significant difference is that, in most cases, desktop 
icons appear against a background color other than white, which seems 
to be the norm in other environments. This can make your icon appear 
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unreadable if you simply copy it from another environment. You should 
test any icons from other environments before using them on the 
desktop. 


Table 4-1 RGB Values for Common Desktop Environment Icon Colors 


RGB RGB RGB RGB 
Values Values Values Values 
Color Decimal Hex Grays Decimal Hex 
Black 0, 0, O #00 Grayl 222, #de 
222,222 
White 255,255, Hff Gray2 189, #od 
255 189,189 
Red 255, 0, 0 #f0000 Gray3 173, #ad 
173,173 
Green 0, 255, O #O0ff00 Gray4 148, #904 
148,148 
Blue 0, 0, 255 #OO0O0Off Gray5 115, #73 
115,115 
Yellow 255, 255,0 #fff00 Gray6 99, 99, 99 #63 
Cyan 0, 255, 255 #O00ffff Gray7 66, 66, 66 #42 
Magenta 255,0,255 #ffOOff Gray8 33, 33, 33 #83 


Implementation of Required Icons 


Formats 


This section discusses the details you need to know to create icons that 
display correctly in the desktop environment, such as formats, resolutions, 
sizes, naming, and so on. 


The desktop runs in both color and monochrome modes, so you must create 
your icons in two formats: XPM for color, and XBM for monochrome. The 
Icon Editor saves icon files to both formats. 
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Note - The monochrome icons generated by the |con Editor usually need 
some further refinement. For example, when converting the colors and 
greys to black and white, parts of the icon may disappear altogether or 
appear too thick. 


In the desktop, buttons and palettes can use either the XBM or XPM 
formats. It is strongly recommended that you use XPM format wherever 
possible for your button, palette, and tool bar graphics. 


The XBM file format has only two colors: foreground and background. In 
the desktop, the foregound color is not fixed, but varies according to the 
background color. |n one color scheme, the background color might be a 
dark gray causing any text or graphics to appear in white. However, a color 
scheme with a light gray background will cause text and graphic to appear 
in black. 


This inverting of the foreground color will have strange effects on certain 
icons. For something simple, like an arrow shape, there is no adverse 
consequence. But for other images, the “negative” version created by the 
inverting of the foreground color might be illegible and, therefore, 
unusable. 


For example, an ice cream cone graphic, with white as the foreground color 
to create a solid white scoop of ice cream on top of an outlined cone, will 
look quite different when the ice cream cone becomes a black outline with a 
black scoop of ice cream. If your application lets users choose the flavor of 
ice cream, a confusing message will be sent to your user when the color 
changes. 
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Figure4-15 Monochrome (XBM) bitmaps, with foreground reversal consequences 


Resolutions 


The desktop accommodates three display resolutions: low resolution 
(640x480), medium resolution (800x600), and high resolution (mega-pixel). 
The size of the Front Panel and some of the icons change automatically 
depending on the display resolution. For this reason, your application must 
provide different sized icons. 


Recommended ew: Any icons or graphics displayed by your application are designed to be 
distinguishable on low- (640x480), medium- (800x600), and high- 
(mega-pixel) resolution displays. Alternatively, your application 
provides different sized visuals for low-, medium-, and high-resolution 
displays.— page 238 
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There are three sizes of the desktop icons: 16x16, 32x32, and 48x48, 
referred to as 16, 32, and 48. (They have suffixes of .t, .m and .1 
respectively.) If your application comes from the PC domain, then the size 
16 and 32 icons used in the desktop should be familiar sizes. Table 4-2 
defines where each size is used. 


Table 4-2 Icon Sizes and Usage 


Component Low Resolution Med. Resolution High Resolution 
File Manager 32, 16 32, 16 32, 16 
Application 32, 16 32, 16 32, 16 

Manager 

Front Panel 32 48 48 

Subpanels 16 32 32 

Front Panel 16 16 16 

Controls 

Minimized 32 48 48 

Window 


Note - 24x24 icons (suffixes of .s) are used for internal application 
graphics like toolbar graphics and are not part of the standard set of 
desktop icons. 
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Table 4-3 lists the icons you need to create for an application. A total of 16 
icon files are needed, assuming one of each type and size. Figure 4-16 on 
page 61 shows an example set of icons. 


Table 4-3 Minimum Required | con Set 


Type of Icon Color Color Color Mono. Mono. Mono. 
16 32 48 16 32 48 

Application Icon ° e e ® ° ° 

Document or File e ° e e 

Icon 

Application e e e e 

Container | con 

Minimized ° ° 

Windows 


Recommended ex: Any icons or graphics displayed by your application are designed to 
display well on black-and-white and gray-scale monitors. These 
visuals also display well on low-color (16) systems.—page 238 


Icon Naming Conventions 


The basic name for the icon must be no more than seven characters. The 
size and color suffixes are appended to the name as shown in Table 4-4. 


Table 4-4 Icon Name Conventions 


Size COLOR B&W B&W Mask 

48 Iconame. 1 .pm Iconame. 1 .bm Iconame. 1_m.bm 
32 Iconame.m.pm Iconame. m.bm Iconame. m_m.bm 
24 Iconame. s.pm Iconame. s.bm Iconame. s_m.bm 
16 Iconame.t .pm Iconame.t .bm Iconame. t_m.bm 


The suffix .pm is for the color XPM format. The suffix .bm is for the XBM 
format. The suffix _m refers to the mask for the black and white icon. 
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Please note that you do not have to provide icons in all these 
configurations. Table 4-3 lists the required icons. For example, the .s icons 
are used primarily for things like tool bars, which your application may not 


have. 


Figure 4-16Example of a minimum required set of icons for Mailer 
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Alignment 


Recommended 


Recommended 


Depending on the graphic you use for your icon, the bits may not take up 
the entire space allocated for the icon. The recommended rules for where 
the empty space goes in a desktop icon are shown in Figure 4-17 on 

page 62. Following these rules ensures your icons visually line up with 
other icons when used in File Manager or on the Front Panel. 


fb: 16x16 and 32x32 icons are left-aligned; any empty bits are on the 
right side of the bounding box.—page 239 


fc: 48x48 icons are centered in the bounding box.—page 239 


Figure 4-17 Example of a left-aligned 32x32 icon with a tag on the right side 


Optional Ic ons Sizes 


There is no 48 requirement for the document or application group icons 
because neither are expected to be used for a minimized window icon (the 
tool’s icon is used instead) or on the Front Panel. But it is possible that a 
user might promote one of these icons to the Front Panel. 
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When a size 48 icon is not available, the Front Panel uses the size 32 icon 
instead. If you think your icons might be used in the Front Panel, you can 
supply size 48 icons. 


Optional Front Panel Icon Style 


The icons that appear by default in the Front Panel have a slightly 
different appearance from File Manager icons. They appear to be etched 
into the surface. This gives the icons a more permanent look, because they 
cannot be dragged and dropped. 


You do not have to provide size 48 icons with an etched appearance like the 
default icons in the desktop. It is not easy to determine if and when your 
icons will be used in the Front Panel; therefore, it is recommended you not 
design specifically for this usage, rather design for File Manager usage 
which will be more common. 


If you decide to design Front Panel icons, the following are instructions on 
developing the etched look. It is strongly recommended that you work with 
a visual designer to implement this style. 


Achieving the Etc hed Look 


You must be familiar with dynamic colors to apply etching. Start with a 
size 48 icon that does not use the entire 48x48 space. The artwork should 
leave a few pixels on all sides for the etching. 
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Figure 4-18E xample of an icon lighted from the top left edge 


The icon has to be rendered with both light and dark colors, preferably 
grays. The icon must be lit from above and to the left. The upper and left 
edges must be light in color, while the lower and right edges must be dark 
in color. Figure 4-18 shows the desktop Text Editor icon before any etching 
has been applied. 
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Figure 4-19 Applying the bottomShadow and topShadow colors 


The etched effect is applied by drawing a single-pixel line of the 
bottomShadow color just outside the upper and left edges of the icon 
artwork, and by drawing a single-pixel line of topShadow color just below 
and to the right of the artwork. 


The lighting model of the icon and of the etched shadow must be consistent 
or the effect does not work. If your icon is drawn with black lines, the 
etched look will be flawed by doubling the dark lines on the top and left 
edges. 
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The style of the icon is critical to making the etched effect look right and to 
making your icon blend in with other Front Panel icons. Study the Front 

Panel icons supplied with the desktop for guidance. | cons with perspective 
scenes, icons with black outlines, and icons on raised “slabs” will not work. 


Evolving the Etc hed Look 


Etching is a way of making the icon appear to be part of the surface it is 
etched on. Not all the parts of an icon have to be etched into the surface. 
You can apply selective etching, making part of the object anchor itself in 
the panel and some of it lie on the panel or protrude from it slightly. 


Figure 4-20 Example of anchoring page while letting pencil protrude from surface 


CDE: Style Guide and Certification Checklist 


4 


The Help icon, for example, takes away the etch, made with the topShadow 
color, under and next to the right-hand book, and replaces it with a select 
color shadow. This makes it appear that one book is protruding slightly 
from the shelf. The printer icon has a protruding paper tray. In the Style 
Manager icon, the palette, letters, and mouse are above the etched-in 
window frame. The File Manager icon has gone the furthest, as only the 
edge of the opening is etched, while the drawer front and the cocked folder 
protrude and even have a shadow. 


The principle is to have something in the artwork anchored, yet let the 3-D 
nature of the objects come out as well. The variable content in an icon, like 
the printer page or the mail envelopes in the Mailer icon, should not be 
anchored. 
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Your application is presented to the user as a series of windows. Some of 
these windows present the main portion of the application. Others are 
dynamic, only appearing to the user when needed to accomplish certain 
tasks. All of these windows should contain menus, border decorations, and 
behavior styles appropriate to their function. The following chapter 
describes the guidelines that should be applied when designing the 
windows in your application. 


Window Contol Guidelines 


Required 


The specifics of the appropriate window borders and decorations are 
outlined in “Window Decorations” on page 70, and the different window 
management behaviors are specified in “Window Management Actions” on 
page 70. 


The fundamental user-visible characteristic of primary windows is that 
stacking, workspace placement, and minimization can be independent of 
other primary windows. Secondary window stacking, workspace placement, 
and minimization must be tied to the associated primary window. 


aa: Application windows should be clearly distinguishable as primary or 
secondary windows based on appearance and behavior.—page 197 


70 


Window ManagementActions 


Required 


Required 


Required 


Required 


aq: 


as: 


at: 


au: 


Windows should follow Common Desktop Environment window 
management functionality conventions, as shown in 
Table 10-2.—page 201 


Primary windows should provide Close, Move, Lower, and Minimize 
as the minimum set of capabilities. They should allow Resize and 
Maximize as appropriate. Secondary windows should be designed so 
that resizing and maximizing are neither necessary nor appropriate. 
Most secondary windows should only include the Close, Move, and 
Lower capabilities. In extraordinary cases, a secondary window may 
provide the Resize and Maximize capabilities. Secondary windows do 
not provide Minimize capability - they are minimized with the 
associated primary window. 


Windows that have form factor constraints need to set Window 
Manager hints for minimum size, maximum size, aspect ratio, and 
resize increment as appropriate.—page 201 


Maximizing a window should show more content (objects or controls) 
if appropriate (as opposed to scaling up the sizes of objects and 
controls).—page 201 


Windows that have Close or Exit functionality need to support the 
window management protocol for Close if there is a window menu. In 
the case of dialog boxes, the Close item on the window menu 
corresponds to the Cancel functionality or dialog box dismissal with 
no further action taken.—page 201 


Window Decorations 


Required 


Window decorations are the user-visible controls in the frame of an 
application window. The Figure 5-1 on page 71 shows some sample 
decorations typically associated with a primary window. 


ab: 


Windows that support particular window management functionality 
must request the corresponding window decoration (for example, a 
window that can be minimized should request the minimize 
button).—page 197 
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Title 


Window menu button Minimize button 


Text Editor — (UNTITLED) 


Resize handle 


Required 


File Edit Format Options 


Maximize button 


Figure5-1 Example primary window decorations 


In addition, windows that support any window management functionality 
(move, resize, minimize, maximize, close, and others) must have a window 
menu with the appropriate items for that functionality. 


ad: Follow Common Desktop Environment window decoration 
conventions, as shown in Table 10-1.—page 198 


Primary windows should have the following window decorations: Border, 
Title, Menu, and Minimize. If appropriate, primary windows should also 
include Maximize and Resize decorations. 


Secondary windows should be designed so that resizing and maximizing are 
neither necessary nor appropriate. Most secondary windows should only 
include the Border, Title, and Menu decorations. If your secondary window 
allows resizing or maximizing, however, it must also include the 
appropriate decoration. The Figure 5-2 on page 72 shows a typical 
secondary window decoration. 
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Window menu button Title 
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Figure5-2 Example secondary window decorations 


Window Menus 


Windows have a menu that allows the user to perform various operations 
that affect the size and placement of the application window. Developers 
should use the following standard window menu items in their applications. 


Required ae: Follow Common Desktop Environment window menu conventions. 


Items should appear in the window menu if they are applicable to the 
window or its minimized window icon.—page 198 


Restore Help 


Minimize 
Maximize 


Lower 


Occupy Workspace... 
Occupy All Workspaces 
Unoccupy Workspace 


Close Alt+F4 


Figure5-3 Sample window menu 
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Optional 


The following items are valid English-language choices in the window menu 
(the mnemonics for each choice are listed in parentheses). They should be 
added to the menu in the order listed. Unless otherwise noted, the 


functi 


onality of these menu items is as described in the OSF/ Motif Style 


Guide, Revision 1.2. 


af: 


Restore (R) 
Move (M) 
Size (S) 
Minimize (n) 
Maximize (x) 
Lower (L) 
separator 


Occupy Workspace ... (OQ) 


Allows a user to specify which workspaces the application 
occupies. 


Occupy All Workspaces (A) 


Enables the user to place the application in all available 
workspaces. 


Unoccupy Workspace (U) 


Removes the application from the current workspace. If the 
application is only occupying one workspace, the item should be 
made insensitive. 


separator 
Close (C) 


Applications should not add items to the window menu. If an 
extraordinary requirement has an application add items to the 
window menu, the items should be appended to the end of the menu 
with a separator between Close and the application itens.—page 199 
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Optional ag: Accelerators, aside from Alt+F 4 for Close, should not be used in the 
window menu (to minimize conflict with other uses of the Alt key for 
application accelerators, localization, and others).—page 199 
Window Icons 
Applications should use icons to represent themselves to the user when 
minimized on the desktop. 
Optional ah: Applications should provide unique window icons for their primary 
windows. The window icon image should have a similar appearance to 
the associated file or Front Panel icon image.—page 199 
Optional ai: The window icon label should contain the same text as the title of the 
corresponding primary window, or an abbreviated form of it. Refer to 
“Layout” on page 202 for window title guidelines.—page 199 
Optional aj: The window icon image should have a similar appearance to the 
associated file or Front Panel icon image. Refer to “Design Philosophy 
and Helpful Hints” on page 50.—page 199 
Window Placement 
Window positioning should be left to the Window Manager or to user 
control. 
Recommended ak: Applications should not require or force windows or window icons to 
be positioned at a particular screen location.—page 199 
Recommended al: A secondary window is placed by the application relative to the 
associated primary window. It should be placed close to, but not 
obscuring, the component that caused it to be displayed and the 
information that is necessary to interact with the dialog 
box.—page 200 
Recommended an: If a secondary window is allowed to be stacked below its associated 


primary window (not constrained to stay on top of the primary 
window), it should be placed such that it is not completely covered by 
the primary window. This recommendation takes precedence over 
other placement recommendations.—page 200 
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Recommended 


ao: If amenu or dialog box is already on display, reinvoking the command 
that caused it to be displayed automatically brings that window or 
menu to the front of the window stack without changing its position 
on the screen.—page 200 


Workspace Management Guidelines 


Recommended 


Recommended 


Desktop applications appear in one of several work areas called 
workspaces. A user may have several workspaces active on the desktop. 
The application should behave in certains ways in relation to those 
workspaces. 


av: When your application creates a new window, it should come up in 
the user’s current workspace and only occupy that single 
workspace.—page 201 


aw: Application windows that are related to a particular task should move 
together between workspaces.— page 201 


For example, a spreadsheet application may have one or more secondary 
windows open that allow the user to change the properties of data cells in 
the main window. If the user moves the main window to a different 
workspace, the properties windows should move with it. 


On the other hand, a word processor may have several windows open, 
where each is used to edit a different document. In this case, when a user 
moves one of the windows to a different workspace, the other windows may 
remain where they are. 


Session Management Support 


Required 


When you design a desktop application, you must consider the following 
guidelines for session management. 


ax: Applications should support Interclient Communications Conventions 
Manual (|CCCM) mechanisms for session management of their 
primary windows and key properties.—page 202 


The ICCCM defines important relationships and behaviors between 
applications and the window manager, including protocols for saving 
and restoring application state across invocations. 
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Required 


Optional 


Optional 


Optional 


Optional 


ay: 


az: 


ba: 


bb: 


be: 


Applications should support |CCCM mechanisms for session 
management of all associated windows (that is, secondary windows 
that may include help windows).—page 202 


Associated windows include multiple primary windows and secondary 
windows, such as online help windows. 


Applications should accept messages from the Common Desktop 
Environment Session Manager that inform them the user is logging 
out and should save their state at that time.—page 202 


Applications that have a single primary window that is open at the 
time the user logs out should restore the primary window, in the 
workspace last occupied, when the user logs in again.—page 202 


Save user context wherever possible. For example, applications that 
support the editing of files should save the state of the file at logout 
and should restore the file in the application window when users log 
in again.—page 202 


Applications that have multiple primary windows that are open at the 
time the user logs out should restore all primary windows, in their 
respective workspaces, when the user logs in again.—page 202 
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You application should present its components to the user in a logical and 
task-organized manner. Menus should follow a common organization and 
naming convention to enable users to use the same rules and practices 
across the desktop. The following sections outline the Common Desktop 
Environment application design and menu structure requirements. 


Component Layout Guidelines 


When you design the physical organization of the controls within your 
application, you should use the following guidelines to ensure that users 
are presented with a consistent interface throughout the desktop. 


Main Window Layout 


Required 61: Your application should be composed of at least one main 
window.—page 202 


A main window contains a client area and, optionally, a menu bar, a 
command area, a message area, and scroll bars. The client area 
contains the framework of the application. The use of a main window 
ensures interapplication consistency. 


Required bd: The default size of the application's main window must be large 
enough to accommodate a typical amount of data, but should not fill 
the entire physical display size to minimize visual conflicts with other 
applications.—page 203 


78 


Required 6-2: 
Required 6-3: 
Required be: 
Menu Bar Layout 
Required 6-4: 


If your application has multiple main windows that serve the same 
primary function, each window closes and iconifies 
separatel y.— page 203 


For example, a text editor might allow the user to edit multiple 
documents, each in its own main window. Each window is then 
treated as a separate application and can be closed or iconified when 
it is not being used. 


If your application has multiple main windows that serve different 
primary functions, each window should be able to iconify 
independently of the other windows.—page 203 


For instance, a debugger might provide separate main windows for 
editing source code, examining data values, and viewing results. Each 
window can be iconified when it is not being used, but it is up to the 
application to decide whether each window closes separately or 
whether closing one window closes the entire application. 


Resize corners should be included in any main window that 
incorporates a scrolling data pane or list.—page 203 


Any changes to the overall size of the window should result in a 
corresponding increase or decrease in the size of the scrollable 
portion. Additionally, your application might reorganize elements 
within the window based on the increased or decreased amount of 
space (for example, it might reorganize a row of buttons into two 
rows). 


Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You must make the appropriate 
changes for other locales. 


If your application has a menu bar, it is a horizontal bar at the top 
edge of the application, just below the title area of the window frame. 
A menu bar organizes the most common features of an application. It 
contains a list of menu topics in cascading buttons; each button is 
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Required 


Recommended 


6-5: 


bn: 


associated with a distinct pull-down menu containing commands that 
are grouped by common functionality. The use of a menu bar yields 
consistency across applications.—page 205 


A menu bar organizes the most common features of an application. It 
contains a list of menu topics in buttons; each button is associated 
with a distinct pull-down menu containing commands that are 
grouped by common functionality. The use of a menu bar is not 
required, but it is strongly recommended. 


The menu bar for your application contains only cascading 
buttons.—page 205 


The use of other types of buttons in the bar precludes user browsing 
of the menu structure. 


There are several common menu operations that should be considered 
“standard”. The standard menu bar entries are File, Edit, View, 
Options and Help. If your application provides that functionality to 
the user, it should be included in the menu bar under the appropriate 
name.The contents of these menu entries are discussed below in more 
detail.—page 205 


Standard menu bar entries should be presented in the following 
order: 


File Edit View Options Help 


You should exclude from your menu bar any item shown in the 
preceding text if your application does not support the associated 
function. For example, if your application does not support the ability 
to display its data in different views, then you should not include a 
View menu. 


You may add application-specific menus in between any of the 
standard menu items, with the following exceptions: 


- The File menu, if present, is located in the first menu position on 
the left. 


- The Help menu is located on the far right position. 
- If File and Edit are present, they should be next to each other. 


For example, your application may have: 
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Recommended 


bo: 


File Edit <category1> <category2> View Options <category3> Help 


Applications that are not file-oriented in nature (or that manage files 
transparently, not exposing this activity to the user) should replace 
the File menu with one or more application-specific 

menus.—page 206 


Possible replacements for the File menu: 
Replacement1: <app-label> Selected 
Replacement2: <app-label ><obj-type> 
Replacement3: <obj-type> 


You may use Replacement! if your application has more than one 
object type. Items on <app-label> would be used for global actions 
that are not specific to an object type. The items in Selected are 
actions that pertain to objects that are currently selected, and may 
change depending on what objects are selected. If nothing is selected, 
this menu should have a single item that says (none selected). If an 
item is selected, but there are no items that apply to that object, this 
menu should have a single item that says (none). 


You may use Replacement2 if your application has a single object 
type. Actions that are global to the application are on <app-label>, 
and actions that are specific to the object type are on <obj-type>. 


You may use Replacement3 if your application has a single object 
type, and does not require an <app-label>menu. For example, a Print 
Manager might contain a Printer menu. 


All other menubar guidelines that apply to File-oriented applications 
also apply to non-File-oriented applications. Thus, the following 
menubar would be valid: 


<app-label > Selected Edit <categoryl> View <category2> Help 


Applications that are complex or are extremely domain-specific (for 
example, an application for medical imaging and diagnosis of cat scan 
data) may require other approaches to their menu bar design. For 
example, 
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<app-l abel ><category1><category2> Selected Edit <object-type> 
Options Help 


Recommended bp: Exit or Close should be located on the first (leftmost) menu of your 
menubar.— page 207 


Common Menu Types 


User actions fall into catagories that are similar across a wide range of 
applications. Your application should use the following standard menus 
when possible to enable the user to easily locate desired functionality. 


File Menu Contents 


Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You need to make the 
appropriate changes for other locales. 


Required 6-7: If your application uses a File menu, it contains the following choices, 
with the specified functionality, when the actions are actually 
supported by your application.—page 208. 


Items should be presented to the user in the order listed below. In all 
cases where a dialog is recommended to be displayed to the user, and 
the dialog has functionality outlined in Chapter 7, “Common Dialogs”, 
your application should use a dialog box. 


© New [REQUIRED] 
Creates a new file. If the current client area will be used to display 
the new file, your application clears the existing data from the 
client area. If changes made to the current file will be lost, your 
application displays a dialog, asking the user about saving 
changes. The mnemonic is N. 


© Open... [REQUIRED] 
Opens an existing file by prompting the user for a file name with a 
dialog box. If changes made to the current file will be lost, your 
application displays a dialog asking the user about saving changes. 
The mnemonic is O. 
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Required 


bq: 


Save [REQUIRED] 

Saves the currently opened file without removing the existing 
contents of the client area. If the file has no name, your application 
displays a dialog prompting the user to enter a file name. The 
mnemonic is S. 


Save AS...[REQUIRED] 

Saves the currently opened file under a new name by prompting 
the user for a file name with a dialog box. If the user tries to save 
the file using an existing name, your application displays a dialog 
that warns the user about a possible loss of data. Does not remove 
the existing contents of the client area. The mnemonic is A. 


Print [RECOMMENDED] 

Schedules a file for printing. If your application needs specific 
information in order to print, it displays a dialog, requesting the 
information from the user. In this case, the menu entry is followed 
by an ellipsis (Print...). The mnemonic is P. 


Close [RECOMMENDED] 

Closes the current primary window and its associated secondary 
windows. This action does not terminate the application - Exit 
should be used for that purpose. If changes made to the current 
primary window will be lost, your application displays a dialog, 
asking the user about saving those changes. If your application 
uses only a single primary window or multiple dependent primary 
windows, this action is not supplied. The mnemonic is C. 


Exit [REQUIRED] 

Ends the current application and all windows associated with it. If 
changes made to the current file will be lost, your application 
displays a dialog, asking the user about saving changes. The 
mnemonic is x. 


If the user chooses Exit, or in any other manner indicates that the 
application should be terminated, but there are changes to the 
current file that have not been saved, your application displays a 
dialog box asking whether the changes should be saved before 
exiting.— page 208 
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The user must always be given the opportunity to explicitly state 
whether unsaved changes should be saved or discarded. A dialog box 
similar to the one described should also be displayed if the user 
chooses Open from the File menu, but has not saved changes to the 
current file. 


<Object-type>and Selected Menu Contents 


The <object-type> menu contains controls that allow the user to create 
instances of the object-type. Both the <object-type> and Selected menus 
allow the user to manipulate object instances. Additional items should be 
added to the <object-type> or Selected menus if they relate solely to the 
manipulation of objects managed by the application (as opposed to more 
generic services that the application might provide). 


Recommended 


br: 


Application Design Principles 


If your application uses an <object-type> menu or a Selected menu, it 
contains the following choices, with the specified functionality, when 
the actions are actually supported by your application. Items should 
be presented to the user in the order listed below.—page 209 


¢ New... [RECOMMENDED] 
Creates a new instance of the object-type. A dialog box is presented 
allowing the user to specify the values for settings associated with 
that object. The mnemonic is N. 


© Move To... [OPTIONAL] 
Allows the user to move the selected objects into a folder. A file 
selection dialog box is displayed allowing the user to select the 
desired folder. The mnemonic is M. 


© Copy To... [OPTIONAL] 
Allows the user to copy the selected objects into a folder. A file 
selection dialog box is displayed allowing the user to select the 
desired folder. The mnemonic is C. 


© Put in Workspace [opTIONAL] 
Allows the user to put a link for the object onto the Common 
Desktop Environment desktop in the current workspace. The 
mnemonic is t 


Any of the preceding three menu choices should be provided only if 
the objects managed by your application are able to reside as separate 
entities outside of your application's main window. For example, a 


printer object created by a printer management application might be 
able to be placed in a Folder window and function as an application 
unto itself. Your application should also support drag and drop as a 
method for performing any of these actions. 


® Delete [opTionaL) 
Removes the selected objects. A confirmation dialog box should be 
presented to the user before the object is actually deleted. The 
mnemonic is D. 


* Properties [RECOMMENDED] 
Displays a Properties window that shows the current values for 
settings associated with the selected object. The mnemonic is P. 


* Default Action> [RECOMMENDED] 
This choice should enact the default action for the selected object. 
“Open” is a typical default. 


Edit Menu Contents 


Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You must make the appropriate 
changes for other locales. 


Required 6-8: If your application uses an Edit menu, it contains the following 
choices, with the specified functionality, when the actions are actually 
supported by your application:—page 211 


© Undo [RECOMMENDED] 
Reverses the most recently executed action. The mnemonic is U. 


© Cut [RECOMMENDED] 
Removes the selected portion of data from the client area and puts 
it on the clipboard. The mnemonic is t. 


© Copy [RECOMMENDED] 
Copies the selected portion of data from the client area and puts it 
on the clipboard. The mnemonic is C. 


* Copy Link _[opTtionaL} 
Copies a link of the selected portion of data from the client area 
and puts it on the clipboard. The mnemonic is K. 
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Recommended 


¢ Paste [RECOMMENDED] 
Pastes the contents of the clipboard into the client area. The 
mnemonic is P. 


© Paste Link [opTIONAL] 
Pastes a link of the data represented by the contents of the 
clipboard into the client area. The mnemonic is L. 


© Clear [RECOMMENDED] 
Removes a selected portion of data from the client area without 
copying it to the clipboard. The remaining data is not rearranged to 
fill in the gap left by the Clear operation. The mnemonic is E. 


* Delete [RECOMMENDED] 
Removes a selected portion of data from the client area without 
copying it to the clipboard. The mnemonic is D. 


© Select All [RECOMMENDED] 
Sets the primary selection to be all the selectable elements in the 
client area. The mnemonic is S. 


* Deselect All [RECOMMENDED] 
Removes from the primary selection all the selectable elements in 
the client area. The mnemonic is I. 


¢ Select Pasted [opTiONAL] 
Sets the primary selection to the last element or elements pasted 
into a component of the client area. The mnemonic is a. 


® Reselect [opTIONAL] 
Sets the primary selection to the last selected element or elements 
in a component of the client area. This action is available only in 
components that do not support persistent selections and only 
when the current selection is empty. The mnemonic is R. 


© Promote [OPTIONAL] 
Promotes to the primary selection the current selection of a 
component of the client area. This action is available only for 
components that support persistent selections. The mnemonic is m. 


bs: If your application does not provide an <object-type> or Selected 
menu, but allows the user to select data within the window and 
manage settings for the selected data, then it provides a Properties ... 
choice as the last item in the Edit menu.—page 212 
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View Menu 


Recommended 


bt: If your application provides a View menu, it only contains functions 
that affect the way the current data is presented. It does not contain 
any option that alters the data itself.—page 213 


Options Menu 
Recommended bu: If your application has global settings that control the way the 
application behaves, it provides an Options menu from which these 
can be set.—page 213 
Help Menu Contents 
Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You must make the appropriate 
changes for other locales. 
Recommended bv: If your application includes a Help menu, it contains the following set 


of choices, with the specified functionality, when the actions are 
actually supported by your application. The Help choices included 
here supercede those listed for Motif 1.2.—page 214 


This is the Common Desktop Environment-recommended Help menu 
and should be used instead of the Motif 1.2 Help menu. Items should 
be presented to the user in the order listed. 


¢ Overview [REQUIRED] 
Provides general information about the window from which help 
was accessed or about the application overall. The mnemonic is v. 
Place a separator after. 


© Index [OPTIONAL] 
Provides an index listing topics for all help information available 
for your application.The mnemonic is |. 


® Table of Contents [RECOMMENDED] 
Provides a table of contents listing topics for all help information 
available for your application. The mnemonic is C. 
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© Tasks [RECOMMENDED] 
Provides access to help information indicating how to perform 
different tasks using your application.The mnemonic is T. 


¢ Reference [RECOMMENDED] 
Provides access to reference information. The mnemonic is R. 


¢ Tutorial [opTioNAL] 
Provides access to your application's tutorial.The mnemonic is |. 


* Keyboard [optional] 
Provides information about your application's use of function keys, 
mnemonics, and keyboard accelerators. Also provides information 
on general Common Desktop Environment use of such keys.The 
mnemonic is K. 


© Mouse [OPTIONAL] 
Provides information about using a mouse with your 
application. The mnemonic is M. 


* Mouse and Keyboard [opTIoNAL] 
Provides information about your application's use of function keys, 
mnemonics, keyboard accelerators and mouse operations. Also 
provides information on general Common Desktop Environment 
use of such keys.The mnemonic is M. 


© On Item [opTIONAL] 
Initiates context-sensitive help by changing the shape of the 
pointer to the question mark pointer. When the user moves the 
pointer to a component and presses BSelect, any available context- 
sensitive help for the component is presented.The mnemonic is O. 


° Using Help [rREquireED] 
Provides information on how to use the Common Desktop 
Environment Help Facility.The mnemonic is U. 


© About applicationname [REquIRED] 
Displays a dialog box indicating, minimally, the name and version 
of your application, and displaying its icon or some other signature 
graphic for your application. The mnemonic is A. 
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The Overview, Using Help and About items are required. The Table of 
Contents, Tasks and Reference items are recommended. You can 
choose to have separate Mouse and Keyboard topics, or have a single 
combined Mouse and Keyboard topic. You should not use all three 
items. 


Attachment Menu Contents 


See Chapter 3, “Drag and Drop” for information on menu recommendations 
your application should use if it supports attachments. 


Pop-up Menus 


Recommended 


Recommended 


Recommended 


Recommended 


Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You must make the appropriate 
changes for other locales. 


Pop-up menus provide access to frequently used functions and should be 
used pervasively throughout the Common Desktop Environment desktop 
environment. A pop-up menu may contain a collection of options that 
appear in different menus available from the menu bar. For example, it 
may contain items from both the File and Edit menus. 


by: 


bx: 


cb: 


ca: 


Your application should provide a pop-up menu for any element that 
is selectable within its data pane.—page 217 


If your application provides functions that apply to a data pane and 
not any specific element therein, then a pop-up menu is provided that 
contains the frequently used data pane functions and is accessible by 
pressing BMenu when the mouse pointer is over the background of 
the pane or a nonselectable element within the pane.—page 216 


The functions accessible from within your application's pop-up menus 
are also accessible from buttons displayed within the window or 
menus accessed through the menu bar.—page 217 


Every pop-up menu in your application has a title that indicates the 
function the menu performs or the element on which it 
operates.—page 217 
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Optional 


Optional 


cd: 


6-11: 


Application Design Principles 


Choices within your pop-up menus are organized in the following 
manner:—page 220 


<choices that manage the object such as Open, Save, and Properties> 
waneenn anne separator ---------------- 

<standard edit menu choices such as Cut, Copy and Paste> 

wanennn nnn separator ---------------- 


<other choices> 


If your application uses any of the common pop-up menu actions, the 
actions function according to the following specifications. See item cc: 
for supplemental guidelines.—page 217 


¢ Properties 
Displays a properties dialog box that the user can use to set the 
properties of the component. 


* Undo 
Reverses the last executed action. 


* Primary Move 
Moves the contents of the primary selection to the component. This 
action is available only in editable components. 


* Primary Copy 
Copies the contents of the primary selection to the component. This 
action is available only in editable components. 


¢ Primary Link 
Places a link to the primary selection in the component. This action 
is available only in editable components. 


°* Cut 
Cuts elements to the clipboard. If the menu is popped up in a 
selection, cuts the entire selection to the clipboard. 


* Copy 
Copies elements to the clipboard. If the menu is popped upina 
selection, copies the entire selection to the clipboard. 


© Copy Link 
Copies a link of elements to the clipboard. If the menu is popped up 
in a selection, copies a link to the entire selection to the clipboard. 


Recommended 


Cc; 


Paste 
Pastes the contents of the clipboard to the component. This action 
is available only in editable components. 


Paste Link 
Pastes a link of the contents of the clipboard to the component. 
This action is available only in editable components. 


Clear 

Removes a selected portion of data from the client area without 
copying it to the clipboard. If the menu is popped up in a selection, 
deletes the selection. 


Delete 

Removes a selected portion of data from the client area without 
copying it to the clipboard. If the menu is popped up in a selection, 
deletes the selection. 


Select All 


Sets the primary selection to be all of the elements in the collection 
with the pop-up menu. 


Deselect All 
Deselects the current selection in the collection with the pop-up 
menu. 


Select Pasted 
Sets the primary selection to be the last element or elements 
pasted into the collection with the pop-up menu. 


Reselect 

Sets the primary selection to be the last selected element or 
elements in the component with the pop-up menu. This action is 
available only in components that do not support persistent 
selections and only when the current selection is empty. 


Promote 
Promotes the current selection to the primary selection. It is 
available only in components that support persistent selections. 


Pop-up menus for selectable objects contain the following set of 
choices, with the specified functionality, when the actions are actually 
supported by your application. These guidelines supplement item 6- 
11:.—page 219 
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Required 


6-12: 


°¢ Move To... 
Allows the user to move the selected objects into a folder. A file 
selection dialog box is displayed allowing the user to select the 
desired folder. 


© Copy To... 
Allows the user to copy the selected objects into a folder. A file 
selection dialog box is displayed allowing the user to select the 
desired folder. 


¢ Put in Workspace 
Allows the user to put a link for the selected objects onto the 
Common Desktop Environment desktop in the current workspace. 


* Delete 
Deletes the selected object. A confirmation is displayed to the user 
before actually removing the object. 


°® Help... 
Displays a help window pertaining to objects of the type selected. 


When a pop-up menu is popped up in the context of a selection, any 
action that acts on elements acts on the entire selection.—page 220 


In the context of a selection, pop-up menu actions affect the entire 
selection. 


General Menu Design Rules 


Recommended 


Recommended 


As you design your application-specific menu panes, follow these guidelines 
to ensure maximum usability and accessibility. 


ce: 


cf: 


If the selection of a menu item will result in the user being queried 
for more information, such as through the posting of a file selection 
dialog, the menu item should be followed by an ellipsis (“...”). This 
requirement does not apply to menu items that will result in a simple 
warning or confirmation dialog being displayed.—page 221 


The use of an ellipsis helps set the user’s expectation for the 
behaqvior of the interface. When they select an item without an 
ellipsis, they know that they can expect an immediate result. 


Menus accessed from within your application contain at least two 
menu items.—page 221 


Application Design Principles 91 


92 


Optional 


Optional 


Required 


Optional 


Recommended 


cg: 


ci: 


6-14: 


cj: 


ck: 


No menu should contain only one item. If your application provides a 
menu with only one item, you should consider moving that item into 
another menu or making it a button within the window. The longer 
the menu, the more effort is needed for the user to access choices near 
the bottom. If your menu has a lot of choices, break it up into two or 
more menus, or group some items into submenus. 


Submenus accessed from within your application contain at least 
three menu items.—page 221 


Submenus may be used to group like items into a single secondary 
cascading menu where putting the items into the primary cascadingd 
menu would make it too long. However, if your submenu contains only 
two options, you should strongly look at removing the secondary 
cascadingd menu and putting the options into the primary cascadingd 
menu since it takes more effort for the user to access options located 
in a submenu. 


If your application contains a menu that is expected to be accessed 
frequently, then a tear-off menu option is provided in that 
menu.— page 221 


The user should be able to tear-off frequently accessed menus so that 
these can remain posted on the desktop as the user uses your 
application. 


If your application uses a tear-off button in a menu, the tear-off 
button is the first element in the menu.—page 223 


Provide keyboard accelerators where appropriate.—page 222 


If specific menu items within a menu are expected to be used 
frequently, not the menu as a whole, then your application provides 
keyboard accelerators for these items and displays the keyboard 
accelerators in the associated menu to the right of the item to which 
they relate. You should not use accelerators that have already been 
defined for system functions - refer to Appendix A, Keyboard 
Functions, for a list of pre-defined key assignments. 


The labels used for items in the menu bar do not appear as options 
within the menus themselves.—page 222 
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Tool Bars 


Required 


Required 


cl: 


6-15: 


The names of items in the menu bar serve as titles for the options the 
menu contains. The name of the menu bar item should provide a term 
that accurately describes the concept of the category relating all of 
the menu items and should not be used as the name of any item 
within the menu itself. 


Any menu choice that is not currently an appropriate selection is 
dimmed (insensitive).—page 222 


Dimmed controls cannot be activated by the user and should appear 
only when the inactive state is short-term (that is, there is something 
the user can do within the application or the desktop environment to 
make the control become active). When the control is persistently 
inactive (because of the current configuration of the application or 
system, or a particular set of companion software is not currently 
installed), the control should be removed from the menu rather than 
be dimmed. 


All menus are wide enough to accommodate their widest 
elements.—page 223 


Tool bars are a method used to provide quick access to things that are 
already user-accessible in an application by other methods. For example, an 
application can provide access to frequently used features from its menus 
through its tool bar. Some common usages of tool bars are navigation, 
changing data views, accessing frequently used tools or editors, simplifying 
the number of steps to complete a common operation, and providing a fast 
path to frequently used menu items. 
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—| Calendar:ant@nika -| J 


File Edit View Browse 


re] 


Week Starting Mon, October 17 1994 


No Meetings Dr appt bd call lunch marianne 
1:00pm-2: 00pm 4:00pm—-5: 08pm 4:30pm—4: 45pm 
Meet w/Dave 1/1 meet todd park 


2:00pm—-3: 08pm 
Meet wi/Frank /K 


Figure6-1 Example from Common Desktop Environment Calendar. 


ool BarGuidelines 


Required fd: If you usea tool bar, it should be used only in windows with a menu 
bar.—page 239 


Required fe: Tool bars should contain only operations that are already available to 
the user in your application menus. All items in a tool bar should be 
redundant.—page 239 


Items in a toolbar are meant to provide quick access to operations 
that are already accessible to the user by other methods. 


Required ff: When an action represented by a tool bar icon is unavailable to the 
user, that icon should be made insensitive, with the associated 
stippled appearance. Whenever a menu item is made insensitive, the 
corresponding tool bar item must be made insensitive as 
well.—page 239 


Recommended fg: Give users the option to hide the tool bar.—page 239 


Design Issues for Tool Bars 


When designing your application and an associated tool bar, consider the 
following issues. 
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* Would the usability of the application be improved by placing these 
items on the tool bar? 


Tool bars should only be used when they improve or enhance user access 
to common operations, such as in an application with several large 
menus. 


® What kinds of operations are being placed on a tool bar? How are they 
grouped? 


Tool bars should present a natural organization of actions. Grouping 
items that are dissimilar can confuse users because they do not expect to 
find the item they are looking for in that context. 


e Is the tool bar too crowded? 


Placing too many items in the tool bar can cause the user to have to 
search for the item they are looking for, rather then being able to quickly 
find it and use it. Keep the number of buttons to a minimum so that you 
don’t increase the difficulty of your application when using a tool bar. 


¢ Are the icons clearly representative of their associated action? 


Cryptic icons add to user confusion. Keep the pixmaps as simple as 
possible. Remember that all graphics must be international in scope. 
When designing a graphic to represent a command, such as Save, 
remember that the icon has to represent a verb, as opposed to a noun 
like most other icons. This can make the icon more confusing to users. 


Tool BarComponents 


Required 


A tool bar is typically constructed using the following Motif components. 


Tool BarContainer 


The tool bar uses a container component to provide a layout mechanism for 
the drawn buttons that make up a tool bar. You may choose most any 
container for the tool bar, as long as it allows for the specified behavior. 


fh: The tool bar container is placed directly under the menu bar and 
should be the same width as the window, as well as similar height to 
the menu bar.—page 239 
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Recommended 


Recommended 


Recommended 


Recommended 


Recommended 


Window Titles 


Optional 


fi: —1f you use a tool bar in your application, then you should provide a 
status line in the same primary window as the tool bar.—page 239 


This status line should provide immediate feedback to the user as to 
the purpose of the button that the mouse is currently over or that has 
the keyboard focus. When the arrow is over a tool bar icon, the status 
line should display a brief definition of what the icon represents or 
what will happen when the user clicks the icon. 


fj: You may provide labels under tool bar icons. These labels should 
serve to explain the purpose of the icon.—page 239 


Tool Bar Button 


The Motif DrawnButton provides an appropriate medium for the graphic 
buttons in tool bars. 


fk: Drawn buttons in the tool bar should be the same width and height. 
Similar or related items should be grouped, and groups should be 
evenly spaced across the tool bar.—page 239 


Pixmap 


The pixmap for the drawn button is the graphic that conveys the 
functionality to be expected by pushing a particular button. 


fl: All pixmaps in the tool bar should be the same size.—page 239 
This ensures that all the buttons will be the same size. 


fm: The recommended size of the pixmap is 24x24. The default for the 
drawn button is to resize itself according to the size of its label type, 
which, in this case, would be a pixmap.—page 240. 


The following guidelines should be followed when defining titles for your 
primary and secondary windows. 


bf: The title of your primary window (the main window your application 
displays to the user) should be the name of your 
application.—page 204 
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Optional 


Optional 


Optional 


Optional 


Recommended 


Optional 


bg: 


bh: 


bj: 


bk: 


bl: 


Note that this does not have to be the actual name of the executable 
invoked by the user. 


Carefully consider how the title you choose for your primary window 
works when it is used in icons and pop-up windows. If the name of the 
pop-up window is too long, you may remove the application title, but 
remember that without the title users might have difficulty telling 
which pop-up windows belong with the originating primary window. 


Use initial capital letters for each word in the title (in languages that 
support capitalization).—page 204 


Follow the application name for each property window, as a 
minimum, with the title Properties and the name of the object it 
affects.—page 204 


Begin the title of each pop-up window with the application title 
followed by a colon, then the title of the pop-up window. The colon 
should have a space both before and after it for readibility.—page 204 


Pop-up windows should always indicate which primary window they 
are associated with (which primary window invoked that pop-up). 


Use a hyphen to denote the current file name, when the application 
has files that can be loaded or saved. The hyphen should have a space 
before and after it. Only the base name of the file should be displayed, 
not the entire path.—page 204 


The hyphen is used to denote specific instances of a window or data. 
The colon serves to delimit general categories or commands. F or 
example, a file manager might have the following title for a 
Properties dialog box: 


File Manager : Properties - myfile 


Follow the application name for each command window with the same 
title that is on the window button or window item users choose to 
display that window.—page 204 


In the case of multiple primary windows, include the application 
name at the beginning of each window title, and add a name that 
uniquely identifies that primary window. No separator should be 
provided for these names (for example, Calendar Manager 
Multibrowse, Catalog Search, Admintool Databases).—page 205 
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Optional 


bm: 


An abbreviated name for the application may be used on other 
windows, so long as it is done on all windows.—page 205 


Work-in- Progress Feedback 


Recommended 


Recommended 


Recommended 


gt: 


gu: 


gv: 


If any command chosen by the user is expected to take longer than 2 
seconds to complete, but less than 10 seconds, your application 
displays the standard busy pointer as feedback that the command is 
executing.—page 246 


The user must receive assurance that your application has "heard" 
the request and is working on it. If the results of the request cannot 
be displayed immediately, some feedback must be provided. The busy 
cursor should be displayed within 0.5 seconds of execution of the 
command. 


If any command chosen by the user is expected to take longer than 10 
seconds to complete, your application displays a working dialog box or 
other feedback of similar character that indicates that the application 
is working on the request. The feedback should reveal progress 
toward completion of the activity. page 246 


If an activity is expected to take a significant amount of time (10 
seconds or more), your application should display feedback stronger 
than the busy pointer. Displaying the busy pointer for long amounts 
of time may lead the user to conclude that the application has become 
"hung." A progress indicator should be displayed in these scenarios 
that indicates that the application is still functioning and is working 
on the user's request. The progress indicator should show how much 
of the activity has been completed and what amount remains. 


When your application displays work-in-progress feedback to the user, 
it does not block access to other applications and services within the 
desktop environment.—page 246 


Multitasking should always be supported and, as such, your 
application should allow the user to access other services while it is 
busy performing some activity. Preferably, the user is also able to 
access other features within your application even though it is 
currently working on another request. When this is supported, your 
application should display an enhanced busy pointer that indicates 
that the application is busy but still willing to accept input. 
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General Applic ation Design Rules 


Required 


Optional 


Optional 


Optional 


Required 


ep: 


eq: 


er: 


es: 


ev: 


There is always exactly one control within any window of your 
application that has the input focus if the window in which it resides 
has the input focus.— page 236 


If any window within your application has focus, some control within 
that window must have focus. The user should not have to explicitly 
set focus to a control within the window. 


When a text field within your application does not have the input 
focus, the text cursor is not displayed within that field.—page 236 


Although use of inactive text cursors is allowed within the Motif style, 
it is better to hide the text cursor on focus out rather than display the 
inactive text cursor. This makes it easier for the user to quickly scan 
the screen or a window and determine which text field currently has 
focus. 


Your application provides keyboard mnemonics for all buttons, 
menus, and menu items displayed within the application.—page 236 


Once the user becomes adept at using your application, keyboard 
mnemonics provide the user a quick way to access functionality. 
Mnemonics also facilitate access to functionality from within 
keyboard-centric applications or windows. The user need not 
frequently switch between use of the mouse or use of the keyboard. 
Mnemonics should be provided pervasively throughout the user 
interface. 


Your application provides keyboard accelerators for those functions 
that are expected to be used frequently by the user.— page 237 


Keyboard accelerators provide the user who has become expert at 
using your application a quick way to access application functionality 
without having to go through menus and dialog boxes. 


If your application does not use the values of global environment 
settings, such as multiclick timeout intervals, drag thresholds, 
window color settings, mouse left- or right-handedness, and so on, but 
instead uses its own values for these settings, then your application 
provides one or more Options dialog boxes that allow the user to 
change the values for these settings.—page 237 
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100 


Required 


em: 


In general, you should not override the value of settings treated as 
global environment settings. These settings are controlled by the user 
through the Common Desktop Environment Style Manager. If you 
choose to ignore these settings and specify your own settings, then 
your application will be have inconsistently with other applications in 
the Common Desktop Environment desktop. If you nevertheless 
choose to provide your own values, then you must provide the user a 
way to make your settings consistent with the rest of the desktop. 


Applications should be installed to folders in the Application Manager 
not directly to the Front Panel or subpanels. For consistency, only 
Common Desktop Environment desktop components will install to 
these locations. Users may choose to rearrange their Front Panel, but 
applications should not do this without user consent.—page 235 
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Use dialog boxes (secondary windows) to support user tasks that require 
detailed interaction from the user and that do not lend themselves well to 
direct manipulation in the main window. F or example, you may not require 
a dialog box to support the task of setting a margin if the task can be 
performed by directly moving a margin stop on a ruler. On the other hand, 
you might require a dialog to support formatting a document if the task 
requires that the user specify several formatting options. 


Dialog Box Design and Layout 


Optional 


Optional 


Optional 


ct: 


cu: 


Cv: 


Keep the size of your dialog boxes to a minimum. Remember that on 
low-resolution displays, dialogs may take up most of the screen real 
estate, and may even run off the edge of the screen if not designed 
correctly.— page 225 


Avoid complexity in your dialog boxes. If your dialog box must support 
many functions, consider using an expandable dialog box (see 
“Expandable Windows” on page 240), or use more than one dialogina 
nested fashion.—page 226 


Avoid the use of resize handles in your dialog box. However, you may 
use resize handles when resizing is useful in allowing users to see 
more information; for example, when your dialog contains a scrolling 
list that is likely to be quite long, and users will frequently need to 
search the list.—page 226 


101 


102 


Recommended 


Required 


Recommended 


cp: The title of dialog boxes used within your application adheres to the 
conventions listed in Table 10-3.—page 223 


cq: Every dialog box in your application has at least one button that 
either performs the dialog box action and dismisses it or dismisses 
the dialog box without taking any action.—page 223 


cr: If your application uses common dialog box actions, the actions have 
the following specified functionality and labels:—page 223 


Label 


Yes 


No 


OK 


<command> 


Functionality 


Indicates affirmative response to a question posed in 
the dialog box. 


Indicates negative response to a question posed in 
the dialog box. 


Applies any changes made to components in the 
dialog box and dismisses the dialog box. 


Applies any changes made to the components in the 
dialog box, performs the action associated with 
<command>, and optionally dismisses the dialog box. 


The <command> button should be used in lieu of OK, Yes, or Noasa 
button label when it provides more meaning to the user as to the 
action that will be performed when that button is clicked. 


Apply 


Retry 
Stop 


Pause 
Resume 


Save As Defaults 


Applies any changes made to components in the 
dialog box and does not dismiss it. 


Causes the task in progress to be attempted again. 


Ends the task in progress at the next possible break 
point. 


Causes the task in progress to pause. 
Causes a task that has paused to resume. 


Saves the current settings as the default settings 
that will appear the next time the window is 
displayed. The settings are not applied to any 
selected object and the dialog box is not dismissed. 
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Recommended 


Optional 


A Save As Defaults button should be provided if it is 
expected that a user would want to use different 
default values for a set of controls within a dialog 
box than those that you provide as the factory 
settings. For example, a Save As Defaults button 
might be provided in a "New <object type>" window, 
allowing the user to indicate that whenever a new 
instance of that object-type is created, the current 
values should be displayed as the defaut settings 
instead of the values given by the application. 


Reset Cancels any changes that have not yet been applied 


by your application. The controls within the dialog 
box are reset to their state since the last time the 
dialog box action was applied. If no changes have 
been applied within the current invocation of the 
dialog box, the controls are reset to the state when 
the dialog box was first displayed. 


Reset to Factory 


Cancels any changes that have not yet been applied. 
Components in the dialog box are reset to their 
default state and value as specified by the vendor 
that delivered the application (that is, the controls 
are restored to the original factory settings). 


Cancel Dismisses the dialog box without performing any 


Help 


cs: 


CW: 


actions not yet applied. 
Provides help for the dialog box. 


Any visible control that is not currently active or whose setting is 
currently invalid is dimmed.—page 225 


Dimmed controls cannot be activated by the user and should appear 
only when the inactive state is short-term (that is, there is something 
the user can do within the application or the desktop environment to 
make the control become active). When the control is persistently 
inactive (because of the current configuration of the application or 
system, or a particular set of companion software is not currently 
installed), the control should be removed rather than dimmed. 


Every dialog box in your application has exactly one default button 
that is activated when the Return key is pressed.—_page 226 
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Optional 


CX: 


The default button should be associated with the most likely response 
from the user and should not be potentially destructive or 
irreversible. Some applications may have dialog boxes that do not 
reveal a default button until a specific set of fields has been filled out 
or otherwise manipulated. 


If a dialog box displayed by your application has controls that are 
considered to be advanced features, use an expandable dialog box, or 
use a multiple page dialog box that provides a <category> option 
menu that allows a user to navigate to each page.—page 226 


Controls that relate to advanced features should not be displayed 
with the set of options initially displayed to the user. The typical user 
should be presented with only those options that are necessary to use 
the basic functionality of the application. Users looking to access 
advanced functionality within the dialog box may use the Category 
option button (see Figure 7-1). If the number of advanced controls is 
very few, or the settings for these controls are highly related to the 
settings of basic controls displayed in the dialog box (that is, the 
settings of the advanced controls change when the user changes 
settings for basic controls), you might choose to provide an 
expandable dialog box (see the section on Expandable Windows and 
Dialog Boxes). 
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|—|Calendar - Options: dcew@dcw. austin, ibm.c 


Category: Editor Defaults — 


Appointment Times: 


Duration: 30 / Minutes 
Start: | 9:00 9:00 —| © AM _)PM 
Reminders 
_| Beep 1 Mins — 
_|Flash | Mins — 
_| Popup 6b Mins — 
_|Mail |q7 lirs — 


Mail To: |ldewSdew. austin. ibm.c 


Privacy: Others See Time And Text | / 


OK | Apply| Reset| Cancel Help | 


Optional 


Figure 7-1 An example of using a Category option menu in a dialog 


dl: Controls within your dialog box are placed in a left-right, top-down 
layout based on the order in which the user is expected to fill out or 


choose options within the dialog box.—page 230 


This assumes that your application is being designed for a left-to- 
right language environment. Alternate design approaches may be 
necessary for other locales. 
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Required 


Required 


Optional 


dm: 


dn: 


do: 


Push buttons that affect the dialog box as a whole, either by 
modifying its contents or layout, invoking the action of the dialog box, 
or dismissing the dialog box, are located at the bottom of the dialog 
box.—page 230 


In general, there should only be one row of buttons at the bottom of a 
dialog box. If your application has dialog boxes that contain several 
global buttons, it may be necessary to create two or more rows of 
buttons at the bottom of the dialog box. The last row should contain 
the standard dialog box buttons (OK, Reset, Cancel, and Help). If a 
dialog box contains buttons that are not related to the dialog box as a 
whole, but instead, relate to a specific control within the dialog box, 
the buttons should be located near the control to which they relate. 


If your application provides an Apply button within a dialog box, it 
also provides an OK button or command button that performs the 
dialog box action then dismisses it.—page 230 


Your application does not use cascading buttons within dialog boxes 
unless there is absolutely no other design alternative that can be used 
without a negative impact on the layout of your dialog 

box.—page 230 


In general, cascade buttons should only be used within menus and 
menu bars. You should avoid their use in all other locations unless 
absolutely necessary. 


Dialog Box Placement 


Recommended 


Optional 


am: 


A secondary window is placed by the application relative to the 
associated primary window. It should be placed close to, but not 
obscuring, the component that caused it to be displayed and the 
information that is necessary to interact with the dialog 
box.—page 200 


Some suggestions are given in section 6.2.4.3, “Determining Dialog 
Box Location and Size,” of the OSF/Motif Style Guide, Revision 1.2. 
Additional or modified recommendations include:—page 200 


If a dialog box does not relate to specific items in the underlying 
window, it should be placed below the menu bar (if there is one) and 
centered (horizontally) over the work area.—page 200 


CDE: Style Guide and Certification Checklist 


7 


Recommended 


Recommended 


ao: 


If a secondary window is allowed to be stacked below its associated 
primary window (not constrained to stay on top of the primary 
window), it should be placed such that it is not completely covered by 
the primary window. This recommendation takes precedence over 
other placement recommendations.—page 200 


If a menu or dialog box is already on display, reinvoking the command 
that caused it to be displayed automatically brings that window or 
menu to the front of the window stack without changing its position 
on the screen.—page 200 


Dialog Box Interaction 


Required 


Recommended 


Required 


All of the navigation and selection guidelines that apply to applications in 
general should apply to your dialogs. In addition, as you design your 
application-specific dialog boxes, you should follow these guidelines to 
ensure maximum usability and accessibility. 


en: 


eo: 


et: 


When your application displays a dialog box, it places the input focus 
at the first text field into which the user is allowed to type an entry, 
or at the first control within the dialog box with which the user 
should interact.—page 236 


Input focus should always be placed at a predictable and intuitive 
location. The user should not be forced to set focus at the control most 
likely to be used when the window is displayed. 


As the user presses the Tab key within dialog boxes of your 
application, the input focus moves to different controls within the 
window in a left-right, top-down order.—page 236 


This assumes that your application is being designed for a left-to- 
right language environment. Alternate design approaches may be 
necessary for other locales. 


Dialog boxes displayed by your application never block input to other 
applications within the desktop (that is, they are not system modal) 
unless it is absolutely essential that the user perform no other action 
in the desktop until the user responds to the dialog box.—page 237 
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Required 


Required 


Applications must allow the user the freedom to access information 
and tools within the user's desktop environment. Only in the most 
dire circumstances should an application ever block access to other 
applications and services within the environment. 


eu: Dialog boxes displayed by your application never block access to other 
functionality within the application (application modal) unless it is 
essential that the state of the application remains unchanged until 
the user responds to the dialog box.— page 237 


6-18: A warning dialog box allows the user to cancel the destructive action 
about which the dialog box is providing a warning.—page 235 


Expandable Windows and Dialog Boxes 


This section describes a standard method for providing expandable 
windows or dialogs in Common Desktop Enviroment. Expandable windows 
allow users to selectively display advanced or application-specific 
functionality in a separate portion of the window that is normally not 
visible when the window is initially displayed. Users can choose to display 
the entire window, or only the core functionality, according to their own 
needs and preferences. Applications can implement expandable windows 
fairly easily using existing toolkit components. 


Use expandable windows only when your application needs to present a 
limited set of additional dialog box options. Consider using an alternate 
method if your dialog would grow unmanageably large, for example, larger 
than a typical low-resolution display could handle. Keep in mind also how 
your dialog will expand when translated into other languages. An 
alternative method for expandable dialogs is to use a multipage dialog and 
provide a Category button for switching pages. 


Guidelines for Expandable Windows and Dialog Boxes 


Recommended 


Recommended 


108 


fn: The primary pane of the dialog box or window should contain all of 
the controls needed to complete the task. This should include all 
critical and frequently used functionality.— page 240 


fo: It is assumed that infrequently used features are placed in the 
secondary pane. The core functionality of the application should not 
depend on any controls placed in secondary panes.—page 240 
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Required 


Recommended 


fp: Command buttons are aligned along the bottom of the dialog box. 
When the window is expanded to show a secondary pane, then 
buttons are moved to the bottom of the secondary pane. See 
Chapter 6, “Application Design Principles” for information about 
layout of action buttons in dialog boxes.—page 240 


fq: If important controls must be placed in the secondary pane, the 
application can specify that the window in question should be 
displayed in its expanded state by default. Users should still be able 
to shrink the window by pressing the Contract button.—page 240 


Components of Exapandable Windows 


To create an expandable window or dialog box, use the standard Motif 
widgets in conjunction with state variables and some simple rules that 
govern its behavior. |n addition to the application-defined controls and 
displays that make up the content of the window itself, use a primary and 
secondary pane in the following way. 


Primary and Sec ondary Panes 


The primary pane should contain the core or base functionality required by 
nearly all end-users of the application. The primary pane is a standard 
Motif container that is the main component of the window or dialog. Only 
the primary pane is visible when the expandable window is initially 
displayed. An “expand button” allows the user to display a secondary pane 
providing access to the full functionality of the window or dialog. [See 
Figure 7-2] 
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Calendar Appointment Editor — ant@nika 


Time What 
Date: 10/20/1994 11:30 lunch marianne 
- 4:30 meet todd parking lot 
Start: | 9:00 9:00 =| ( AM _ )PM 
End: 10:00 10:00 = | ( AM —)PM 
What: | 


| 


Drag Appt 


Insert | Change Delete Clear Cancel Help 


Figure 7-2 Calendar Appointment Editor primary pane with Expand button (More) 


Expanding the Sec ondary Pane 


The secondary pane provides space for additional options or advanced 
functionality without increasing the difficulty of the core functionality in 
the primary pane. The secondary pane can be expanded in a vertical or a 
horizontal direction. To determine the appropriate direction in which to 
expand, consider the following questions: 


© What are the reading patterns in the countries that will be using the 
applications? 


© What makes the most sense based on the information in the dialog? 
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Recommended 


Recommended 


Required 


Required 


fr: 


The secondary pane should expand in the direction most consistent 
with users’ expectations, the reading pattern of the language in which 
it will be displayed, and the content of the information 

displayed.— page 240 


If possible, the panes should have the same default width.—page 240 


A separator should be used to separate the primary pane from the 
secondary pane.—page 240 


The user needs to have clear visual feedback as to which elements are 
part of the primary pane and which elements are part of the 
secondary pane of the expandable window. 


Resizing the Expanded Window or Dialog 


fu: 


If a window is resizable, any sizing changes should be allocated to the 
pane containing scrolling lists or text fields whose displayed length is 
less than their stored length. I f both panes contain scrollable controls, 
size changes should be distributed evenly between the two panes. | f 
neither pane contains scrollable controls, the window should not be 
resizable.—page 241 
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=| Calendar Appointment Editor — ant@nika al 


Time What 


Date: 10/20/1994 11:30 lunch marianne 
— 4:30 meet todd parking lot 
Start: | 9:08 9:00 = ( AM _)PM 


End: 10:00 10:00 =| ¢ AM  )PM 


What: | A FZc| 
r Drag Appt 


Frequency Yeminders 


Occurs: One Time | f | Beep 5 Mins — 
Fort H f _| Flash Mins 
Popup | 

Privacy: Others See Time And Text | / | 


_| Mail if the 


Mail Tax R 


Insert | Change! Delete Clear Cancel Help 


Figure7-3 Calendar Appointment Editor with expand button (Less) and primary 
and secondary panes 
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Expand Button 


The expand button is used to display the secondary pane. The expand 
button is a standard Motif drawn button with a label that changes 
depending on the state of the window. The button labels for the two states 
should tell the user what will happen. For example, the button might say 
Options when the window is closed and Basic when the window is open. 
Clicking the Options button displays the bottom pane; clicking the Basic 
button hides the bottom pane. Labels should be opposites such as Expand 
and Contract, More and Less, or Basic and Options. 


Required fv: The expandable window should have one button that changes its label 
based on the state of the window.—page 241 


Required fw: The expand button should have two labels that reflect the two states 
of the expandable window accurately. The current label should 
indicate to the user what will happen if the user clicks the 
button.—page 241 


Examples of possible labels are Basic and Options, Expand and 
Contract, and More and Less. 


Optional fx: The expand button may contain a graphic in addition to the label. 
This graphic should indicate the direction in which the window will 
expand or contract.—page 241 


Placing the Expand Button 


Recommended fy: The button should appear in the lower left-hand corner of the window 
or dialog box for expansion in the vertical direction and in the lower- 
right hand corner for expansion in the horizontal 
direction.—page 241 


Required fz: If the window or dialog box contains a scrolling list positioned to the 
far right side of the pane, do not align the drawn button with the 
scroll bar. For example, the button should be aligned with the list, not 
the scroll bar.—page 241 
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Required 


Recommended 


File Selection Dialog Boxes 


Contents 


Required 


114 


Window State 


ga: 


gb: 


Applications must remember the state of each window or dialog box 
(expanded or not expanded) independently (not collectively). The state 
should be changed only by the user and should always be preserved 
until explicitly altered by the user.—page 241 


Applications should remember the state of each expandable window 
or dialog box across sessions, so that users don’t have to manually 
configure the expandable windows each time the application is 
run.—page 241 


If appropriate, applications can provide a mechanism to allow users to 
set the state of an expandable window on a global basis in the 
application. This would be part of the application’s Options. 


The Common Desktop Enviroment file selection dialog box is a subclass of 
the Motif file selection dialog box that has enhancements for improved 


usability. As long as your application uses the standard Motif file selection 
dialog box calls, the Common Desktop Enviroment enhanced version will 
appear in the Common Desktop Enviroment environment. There are 
additional guidelines to follow to make your dialog consistent and easy to 
use. Use the file selection dialog box whenever your application supports a 


task that involves choosing a file or directory. Examples are: Open, Include, 


Save As, and Copy To. 


7-10: |f your application uses a file selection dialog box, it contains the 


following components:—page 249 


© A directory Text component showing the current directory path. 
The user can edit the directory Text component and press 
<Return> or <Enter>to change the current directory. 


© A group of push buttons, including a command button, and U pdate, 
Cancel, and Help buttons. The command button is typically labeled 
Open or Save, but if there is another label that better describes the 
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resulting action (Such as Include), that label should be used. 
Activating the command button carries out the corresponding 
action and dismisses the file selection dialog box. 


For applications that allow saving to different formats, an option 
button allowing users to specify the format when saving a file. 


A file name Text component for displaying and editing a file name. 
This component is optional when the file selection dialog box is 
used to choose an existing file or directory. 


J ==] 


Text Editor — Open a File 


— 


Enter path or folder name: 


a feose/cline/cde/dticon/ 
Filter Files 

Filter text — admindefines 

field ai i . Contents 

admindefines. org List 

Folders constants.h 
SEE Oticon 

Folder list 


File text field i 


~———_hitmaps dticon 


nis dticon.man 


pixmaps dticon.msg 
dticon.ptype 


Enter file name: 


‘ 


Pushbuttons 


| OK | Update | Cancel | Help 


i n 


Figure 7-4 Example of an Open file selection dialog box 
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Required 


Optional 


Recommended 


Recommended 


Required 


7-17: The file selection box displays the contents of a directory in the 


ht: 


de: 


df: 


dg: 


contents list when the file selection box is initialized, when the user 
presses Enter or Return in the directory text component, and when 
the user opens a directory in the contents list. The contents list is 
updated each time the contents of the directory changes.—page 252 


This specification ensures the consistent operation of a directory and 
file search in a file selection dialog box. 


Directory and file name lists should be presented alphabetically, case 
insensitive. The first item on the directory list should be the parent 
directory and it should be labeled “..”.—page 253 


The file selection dialog box should not display hidden (dot) 
directories or files, unless your users depend on using these types of 
files. If your application does support displaying hidden files, you 
should supply a check box allowing users to toggle between showing 
and not showing hidden files, or else allow users to toggle between 
showing and hiding files at a global level in your 
application.—page 228 


The file selection dialog box should not show the full path names for 
files and directories, but should only show the relative names, except 
for the directory text field—page 229. 


The global Common Desktop Enviroment setting should be: 


XmFileSelectionBox.fullPathMode: false 


Unless your application overrides this behavior, your file selection 
dialog box should not show full path names in the list boxes. 


In general, the file selection dialog box should recall the directory 
location that was previously set by the user.—page 229 


For example, if the user brings up Save As and navigates to 
/users/jay/letters to save the file, the next time the user brings 
up Save As, the file selection box should be in the directory 
/users/jay/letters. This information, however, should not be 
recalled once the user has closed the primary window, but should 
resort to the default directory. 


If your application supports multiple primary windows, each window 
should recall the directory location that was set for that window. 
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File Selection Dialog Box Behavior 


Optional 


Optional 


Optional 


Labeling 


Optional 


Optional 


Recommended 


hq: 


hr: 


hs: 


hu: 


The file selection dialog box should come up in a directory that makes 
sense for the task. For example, when saving a new file from an 
editor, the file selection box should come up in the user’s home 
directory. |f the user navigates to some other directory within the file 
selection box, the application should remember that directory the 
next time it is brought up.—page 253 


Users should never be allowed to overwrite an existing file through 
the file selection box without a warning dialog box 
prompt.—page 253 


Keyboard focus should be placed in the file name field each time users 
bring up a file selection dialog box.— page 253 


Labels should be clear. In the English language, use the following 
labels for the file selection dialog box fields and lists:—page 254 


Component Label 


Directory text field Enter Path or Folder Name 


Filter text Field Filter 

Directory list F older 

Contents list Files 

File text field Enter Filename:* 

hv: Optionally, application developers can make this label more 


he: 


instructive and specific, such as Enter File to Open for Open dialog 
boxes.—page 254 (see following sections for specific 
recommendations). 


These labels should be the default labels. If they are not set by 
default, you need to set them via resources in your application's app- 
defaults file. 


When the file selection box is used to specify an existing file (for 
example, to open a document), the command button is normally 
labeled Open and it should be the default action.—page 250 
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Required 


Button Activation 


Recommended 


Required 


hj: 


hf: 


hg: 


When the file selection dialog box is used to specify a new file name 
(for example, a Save As dialog box), the command button is normally 
labeled Save and is the default action. This specification ensures the 
uniform appearance of a file selection box across 
applications.—page 251 


If the Update button is activated while a directory is selected in the 
contents list, the directory is opened, its contents are displayed in the 
contents list, and the directory text is updated.—page 250 


If the Open button is activated while the appropriate file is selected in 
the contents list, the file is utilized by the application and the file 
selection box is dismissed.—page 250 


Selection and Navigation 


Required 


Required 


7-12: 


7-13: 


Double-clicking BSelect on an item in the contents list selects that 
item and activates the default action. In all cases, double-clicking 
BSelect on a directory in the contents list opens that directory and 
displays its contents in the contents list (the default action is 
Open).—page 251 


* When the file selection dialog box is used to choose an existing file, 
double-clicking BSelect on an appropriate file in the contents List 
chooses that file and dismisses the file selection dialog box (the 
default action is Open). 


¢ When the file selection dialog box is used to choose an existing 
directory or to specify a new directory or file, the files list should 
not appear. 


The normal text navigation and editing functions are available in the 
text components for moving the cursor within each text component 
and changing the contents of the text.—page 251 


These actions provide a convenient way to choose a directory or file 
name from the corresponding List while focus remains in the Text 
component. 
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Optional 


Required 


7-15: 


7-16: 


Your application allows the user to select a file by scrolling through 
the list of file names and selecting the desired file or by entering the 
file name directly into the file selection text component. Selecting a 
file from the list causes that file name to appear in the file selection 
text area.—page 252 


This method for selecting a file needs to be consistent across 
applications. 


Your application makes use of the selection when one of the following 
occurs:—page 252 


* The user activates the command push button while an appropriate 
item is selected in the contents List. 


® The user double-clicks BSelect on an appropriate file in the 
contents list. 


* The user presses Return or Enter while the file name text 
component has the keyboard focus and contains an appropriate 
item. 


Guidelines for Specific File Selection Dialog Box Uses 


The following guidelines apply for specific uses of the file selection dialog 
box, and should be observed in addition to the more general guidelines. 


Recommended 


Required 


Open Dialog 


hm: 


hn: 


If the user has opened the application without supplying a file name 
argument, the Open dialog box should use the user’s home directory 
as the default directory.—page 252 


An exception to this rule might be made if a clearly more useful 
directory can be identified; for example, the icon editor might default 
to SHOME/.dt/icons. For applications that allow editing, never 
default to a directory in which the user does not have read and write 
permission, such as /usr/dt/bin. 


If the user has opened the application with a file name argument, the 
Open dialog box should default to the directory in which that file 
resides.— page 253 
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Optional 


Optional 


Recommended 


Required 


Optional 


Save As Dialog 


ho: 


hp: 


When using the file selection dialog box in Save As capacity, providea 
default name of Untitled, place the location cursor in the file name 
field and highlight the file name text to create a “delete pending type- 
in” mode. If the current directory already has a file of that name, 
create a name Untitled2, and so forth._—page 253 


When using the file selection dialog box in a Save As capacity, add a 
file name extension if the application supports file typing by 
extension, and make this extension visible in the file name field. Do 
not highlight the extension to create a “delete pending type-in” mode, 
but allow users to modify the extension or delete it 

explicitly.— page 253 


After saving a file using “Save As”, the application should use that 
newly saved file as the current file, and all subsequent edits and 
saves should apply to that newly created file. 


The Save As dialog should use the same directory in which the 
current file resides. 


Direc tory Selection Dialog 


hh: 


hi: 


hk: 


When the file selection dialog box is used to choose an existing 
directory (for example, to install a set of files into the chosen 
directory) or to specify a new directory, the command button should 
be given an appropriate label, such as Install, Choose, Create, or OK. 
If this button is activated while the appropriate directory is selected 
in the contents list, the directory is utilized by the application and the 
file selection box is dismissed.—page 250 


When the file selection dialog box is used to choose an existing 
directory, there must also be an additional button, labeled Update, 
that is enabled whenever a directory is selected in the contents list, 
and opens the directory. This Update button is the default 
action.—page 250 


When the file selection dialog box is used to choose an existing file, 
files are shown in the contents list but they are all disabled. Double- 
clicking BSelect on a disabled file name has no effect.—page 251 
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Print Dialog Box 


These are guidelines for a common look and feel print dialog box, which 
may be used wherever a print action is available. The print dialog is not a 
widget. Developers are encouraged to use these guidelines as a starting 
point and to add functionality as appropriate for their applications. It is 
important, however, to remember that users expect consistency from one 
print dialog to another; therefore, the common area should be left as 
unchanged as possible. Use a print dialog box whenever users would want 
to select options for printing a file, a selection, or other type of object. If 
your application supports printing, you should use a print dialog box, and 
you may provide an optional nondialog method of printing directly, that is, 
“silent” printing. 


Standard Print Menu Items for Applic ations 


Print...: brings up a print dialog so the user can choose from the available 
options before printing the selected objects. 


Print One: prints one copy of the selected objects, using the default print 
methods previously defined by the user. The user is not prompted for 
further information through a dialog. 


Guidelines forC ommon Print Dialog Functions 


Applications are expected to provide many different types of printing 
functions and capabilities. This section provides guidelines for the 
most commonly used types of print options so that appearance and 
behavior for these items is consistent across applications. These 
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common items are grouped into a common area that is located in the 
top portion of the print dialog. Figure 7-5 on page 122 shows a typical 
print dialog. The common area is the area above the separator line. 


File: ftpinto 


Printer: | Default Copies: | 1 Common 
— “ area 


Banner Page Title: |Julie’s Print Jo 


Ww Print Page Numbers 
App-specific 


B area 
Print Command Options: E 


| Print | Cancel | Help | 


Figure7-5 A basic print dialog. box 
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The common area contains the following components: 


Dialog Title: Print 


File: this is a noneditable field. It displays the file name (if 
available). If the user is printing a nonfile object, this field should 
display the object type if possible (for example, mail message, 
calendar appointment). 


Printer: A combination box; could also be a text field. It contains 
the name of the printer destination. The default entry is labeled 
Default, that is, whatever printer is the default destination. The 
user may select or type any other valid printer name. If it isa 
combination box, the list of printers could reflect what is 
appropriate for that printing job. The dialog should retain the last 
user entry or selection made. 


Copies: A spin box (numeric widget) where the user selects or types 
the number of output copies desired. Optionally, this could bea 
text field. 


Banner Page Title: A text field where the user may enter the text 
the user wants to appear on the banner page (that is, cover page) of 
their output. This field should pick up the default banner title if 
the user has set it elsewhere. Optionally, you could add a check box 
to turn the banner page off completely. 


Separator lines: Used between the common fields, the application- 
specific fields, and the buttons. 


The print dialog contains the following standard buttons: 


Print: Accepts the user’s choices in the dialog, prints the selected 
objects, and exits the dialog. 


Cancel: | gnores the user’s choices in the dialog, prints nothing, and 
exits the dialog. 


Help: Brings up an associated Help window. 


Optional buttons could include Reset, Print Preview. 
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Guidelines for Applic ation- Specific Print Dialog Box Functions 


The standard print dialog application-specific area is the bottom half of the 
dialog box illustrated in Figure 7-6 on page 126. 


Depending upon the application or function, developers may choose to add 
more fields to the common Print dialog. The controls in the dialog are laid 
out horizontally; if more fields are needed, it is suggested that you add 
another separator line, then place the additional controls below it, as 
illustrated. If any additional push buttons are needed, they should go 
between the Print and Cancel buttons. 


Optional Fields 
Some possible optional fields include: 


Print Page Numbers 
This checkbox applies only when ASCII files are 
being printed. If the objects selected for printing are 
non-ASCII, this control should be dimmed. When 
turned on, output pages will be numbered. 


Print Command Options 
A text field where the user may type an 1p command 
or script name to override the instructions in the 
other fields. If you want to provide print methods 
besides 1p, rename this field (Print Method, Use 
Print Command, and so on.). 


Priority This might be an option menu containing values for 
High, Medium, and Low, or might be a spin box 
containing numbers. 


Orientation An option menu containg the values Portrait and 
Landscape (see Figure 7-6 on page 126). 


Resolution An option menu or a spin box containing numeric 
values, in dpi (See Figure 7-6 on page 126). 


Sides An option menu containing the values Single and 
Double (see Figure 7-6 on page 126). 


Paper Size An option menu containing the values Letter, Legal, 
and so on. (Figure 7-6 on page 126). 
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Paper Source An option menu containing the values Upper Tray, 
Lower Tray, and so on. (See Figure 7-6 on page 126). 


If the dialog box is to be used for an application, consider: 


Page Range Two text fields, from x to y (see Figure 7-7 on 
page 127). 


Reduce/E nlarge A spin box containing values for percentages (see 
Figure 7-7 on page 127). 


Print Preview A button that brings up a WYSIWYG representation 
of the output. 


Some Sample Layouts 


Figure 7-6 on page 126 and Figure 7-7 on page 127 show some example 
Print dialog box layouts. 
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Figure7-6 Example print dialog box layout for general printing 


CDE: Style Guide and Certification Checklist 


Figure7-7 Example print dialog box layout for printing from applications 


Common Dialogs 


127 


The Properties Dialog 
User a properties dialog if your application provides settings that control 
the behavior of an application or the characteristics of an object. 
Guidelines 
Recommended cz: If your application manages objects and allows the user to see or 
modify settings for these objects, these settings are displayed in an 
object properties window that is accessible from a Properties ... choice 
in the Edit, <object-type>, or Selected menus, as well as from the pop- 

up menu associated with the object.—page 227 

Recommended da: If your application provides access to a Properties or Options window, 
this window includes the following set of buttons in the order listed, 
with the specified functionality, when supported by your 

application.—page 227 

OK Applies any changes made to components in the 
DialogBox and dismisses it. OK may be replaced by a 
more appropriate label (for example, Add). The 
alternate label should be a verb phrase. 

Apply Applies any changes made to components in the 
DialogBox and does not dismiss it. 

Reset Cancels any changes that have not yet been applied by 
your application. The controls within the DialogBox 
are reset to their state since the last time the 
DialogBox action was applied. If no changes have been 
applied within the current invocation of the 
DialogBox, the controls are reset to their state as of 
when the DialogBox was first displayed. 

Reset to FactoryCancels any changes that have not yet been 
applied. Components in the dialog box are reset to 
their default state or value as specified by the vendor 
that delivered the application (that is, the controls are 
restored to the original factory settings). 

Cancel Dismisses the dialog box without performing any 
actions not yet applied. 
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Recommended 


The About Dialog Box 


db: 


Help Provides help for the dialog box. 


If your application provides a Properties window that displays 
settings for a selected object, the Properties window tracks the 
current selection and modifies the state of any controls to accurately 
reflect the properties of the currently selected object.—page 228 


The About dialog box is used to present version and other information 
about your application. Use as the dialog that comes up when the user 
chooses About <application name> from the Help menu. 


Guidelines forthe About Dialog Box 


The About dialog box should contain a minimum set of information about 
the application that is visible in a single text pane. 


Required 


Recommended 


Optional 


That minimum set should be: 


di: 


© Application name 
© Version number 
© Release date 

* Copyright 


The About dialog box should contain a Close button. Other buttons 
are optional, such as Help and More —page 229 


The following information might also be contained in the About box: 


dj: 


dk: 


Information about the operating system or other aspects required to 
run the application, for example, Common Desktop Environment 
1.0.—page 229 


A More Information dialog box for additional information such as 
development team credits, licensing, client or xhost 
information.—page 229 
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About Application Builder 


Application Builder 
Verion 0.9 
October 1994 


HP, IBM, SUN, NOVELL 


Copyright (c) 1994-1995 


Figure 7-8 Example About dialog box 


About Application Builder 
Application Builder 


Verion 0.9 
October 1994 


HP, IBM, SUN, NOVELL 


Copyright (c) 1994-1995 


| More... | Close | 


Figure7-9 About dialog box with a More button 
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From time to time, an application needs to present feedback to keep the 
user informed about the progress of ongoing activities and to alert the user 
to situations that require intervention. The Common Desktop Environment 
Motif interface provides many ways to provide such feedback to the user. 
This section describes the use of error messages, informational messages, 
and other message dialog boxes. 


Enor Messages and Informational Messages 


Error messages and informational messages are appropriate in different 
situations. Present an error message when it is crucial to bring the 
information to the user’s attention because the intended action cannot be 
carried out without user intervention. Present informational messages to 
describe progress, indicate short-term status, or give helpful suggestions. 
Informational messages should be gentle and nondisruptive to the flow of 
activity. Therefore, you must assume that the user may not notice 
informational messages. If it is important that your users see a particular 
piece of information, present it in an error dialog box or in another type of 
message dialog box. 


131 


EnorMessages 
Use error messages to present crucial messages to the user when user 
intervention is necessary for the successful completion of an operation. 
Error messages are intended to bring a problem to the user's attention and 
to help the user resolve the problem. 
Guidelines for EnorMessages 
Use a Motif error dialog box to present application error messages. 
Figure 8-1 shows a typical error dialog box. Keep in mind the basic three 
part structure for error messages. Whenever possible, each message should 
tell the user: 
* What happened 
¢ Why it happened 
® What should be done to correct the problem 
—| CAD Master 

The file ’Retooling’ was not copied 

because a buffer overflowed. 

Recopy file? 

Recopy| Cancel Help 
Figure8-1 An error dialog box. 
The text describes the error, why it happened, and offers to retry the 
operation. A Help button in the lower right will bring up appropriate online 
documentation. 
Recommended gd: Error messages displayed by your application indicate the possible 
cause of the error and indicate the possible actions the user can take 
in response.—page 242 
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Recommended 


Optional 


Optional 


Keep the information in the ErrorDialog clear and concise. The idea is 
to alert users to the problem, have them quickly understand the 
problem, and learn how to recover from it. A large amount of text 
makes it more difficult for the user to focus on the critical 
information. 


gc: Messages displayed by your application do not assume that the user 
has any expert knowledge about computer systems in general, or the 
UNIX system in particular.—page 242 


It is appropriate to assume that the user has knowledge about basic terms 
used within the desktop, such as files or programs. Such knowledge can be 
assumed to have been learned by the user through tutorials, online help 
and user documentation. However, terminology that is typically understood 
only by an expert or frequent computer user should be avoided unless the 
application is specifically targeted at computer professionals. Likewise, 
messages returned to your application by the underlying operating system 
should not be passed through to the user, but instead, should be 
“translated” into language that can be understood by the novice user. 


Try to make the error message specific to the immediate situation and as 
helpful as possible. For example, if the user has entered an invalid name, 
the error message should not simply state that an invalid name was 
entered. Instead, tell the user which character was invalid. If the rules for 
valid names are simple, describe them in the error message; otherwise, 
describe the rules in the online help and give the user access through the 
Help button. 


In many cases, the only user response to an error dialog box will be to click 
the OK button to dismiss the dialog box. However, often it may be possible 
to offer to resolve the problem for the user. If you have buttons for user 
actions, be sure to also include a Cancel button. 


ge: Your application uses audio feedback, in addition to any messages 
displayed, to signal error conditions and events.—page 242. 


gh: Urgent conditions that require immediate attention by the user, no 
matter which application or desktop service the user is currently 
accessing, are brought to the user's attention using audiovisual 
notification. The alarm is signaled in the current workspace 
regardless of the workspace in which the application 
resides.— page 243 
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Optional 


Some applications, such as network monitors or stock watch 
programs, may need to grab the user’s immediate attention to some 
event. Both visual and audio alarms should be used to signal the user. 
The user should be able to acknowledge the alarm and cause it to 
cease. 


Keep in mind that the user may be running several applications at once, 
and may be focused on another application while your application is 
running in the background and encounters an error. The application name 
should appear in the title bar, to help the user identify the source of the 
error message. 


Once users have read an error message, they may need to access other 
parts of their system to resolve the problem. Whenever reasonable, posting 
an error dialog box should not block further interaction with your 
application and, if at all possible, it should not block other applications. 


gq: Your application writes error messages to the Common Desktop 
Environment error log when it is not appropriate to display these to 
the user in a message dialog box, but when the message may 
nevertheless be useful in diagnosing problems.—page 245. 


You might also write error messages that are displayed to the user in 
the error log if it would be valuable to the user or an administrator to 
refer to these messages at some later time. Messages written to the 
error log should provide additional information about the error and 
should state the context in which the error occurred. 


Accessto Online Help 


Recommended 


gj: Your application provides a Help button in all message dialog boxes, 
except those that contain self-explanatory messages.—page 243 


Applications should be designed with both the expert and novice user 
in mind. The novice user must be able to access additional 
information clarifying the message, the circumstances under which it 
might have been displayed, and what the user should do in response 
to the message. 


The brief description of the problem in the ErrorDialog should be sufficient 
for the experienced user, but may not contain enough information to enable 
less experienced users to resolve the problem. Rather than confusing the 
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Helpful Hints 


Optional 


Informational Message 


dialog with additional text, use the Help button to take the user directly to 
the online documentation for a more detailed description of the error, its 
causes, and methods for resolving the issue. Users who still need additional 
help can browse the general online help facilities from there. A few notices 
may not need Help buttons because the text of the message will cover the 
condition sufficiently. 


For more information on how to access online help directly from the error 
dialog box see the Help System Author’s and Programmer's Guide 


gh: Urgent conditions that require immediate attention by the user, no 
matter which application or desktop service the user is currently 
accessing, are brought to the user's attention using audiovisual 
notification. The alarm is signaled in the current workspace 
regardless of the workspace in which the application 
resides.— page 243 


Applications should not send messages to command entry windows or to the 
UNIX console (that is, applications should not write to the default UNIX 
files stdout or stderr). Applications are often launched by double-clicking 
icons in the File Manager, Front Panel, or Application Manager, which 
means users will not see messages that are written to stdout or stderr. 
Even if the application is launched from a terminal window, the user may 
subsequently close the terminal window, and messages appearing there will 
often not be seen. Worse, if the user does not have a console window 
running (the console window is difficult to launch in Common Desktop 
Environment), messages intended for the console may blast across the 
screen and make everything look ugly. 


S 


Use informational messages in the window footer to present progress, 
status, or helpful information to the user. Informational messages should 
not be used to present crucial information, because informational messages 
are deliberately designed to be nonobtrusive and many users may not 
notice them. 
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Guidelines for Informational Messages 


Recommended gi: Your application uses footer messages only to communicate status, 
progress, or information (help) messages. It does not use the footer to 
present error messages.—page 243 


Motif provides a message area at the bottom of the main window, but this is 
rather clumsy and ugly. A more elegant approach is to provide a wider 
margin below the data area of the main window where status information 
can be unobtrusively displayed, as shown in Figure 8-2. For other examples 
of the use of informational messages, see the status message area in the 
Common Desktop Environment Mailer. 


| Loading earthgit.Doe 


Figure8-2 An informational message in the lower margin of a window. 


The text “Loading earth.gif...” is displayed at the start of the load and the 
text “Done” is added when the load completes. The entire message is 
removed 5 seconds later. 


Informational messages in the footer area should be left-justified and 
displayed in a light font in keeping with their unobtrusive nature. Note 
that the margin where informational messages are displayed should not 
accept mouse focus. Progress messages in the footer area should normally 
be displayed only while the operation is in progress. Notices and other 
information that is no longer valid should be removed within a few seconds 
to avoid confusion about whether the information is current. 


OtherMessage Dialogs 


Recommended gk: Your application uses the appropriate style dialog box for the display 
of messages to the user.—page 243 
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Optional 


Optional 


Optional 


gl: 


gn: 


go: 


An information dialog box is used to display status, completion of 
activity, or other informative types of messages to which the user 
need not necessarily respond other than to acknowledge having read 
the message.—page 243. 


Minimally, information dialog boxes should have an OK button so 
that the user can dismiss the dialog box. If there is additional 
information available about the situations under which the message 
is displayed or other references for the topic to which the message 
relates, then a Help button should be included. 


A question dialog box is used to ask questions of the user. The 
question is clearly worded to indicate what a Yes response or a No 
response means. The buttons displayed are Yes, No, and Help. Help 
provides additional information as to what the application will do in 
response to a Yes or No choice —page 244 


Where possible, you should replace the label for the Yes and No 
buttons to make it clear what action will be performed as a result of 
choosing either option. For example, if the user has made changes to 
a document and has not saved these but has chosen the application's 
Exit option, you might display a question dialog box that asks, 
“Changes have not been saved. Do you want to save these before 
exiting?” The buttons should be Save, Discard, Cancel, and Help. 
These labels allow the more experienced user to click the correct 
button without having to carefully read the question and relate it to 
the button labels. 


A warning dialog box is used to communicate the consequences of an 
action requested by the user that may result in the loss of data, 
system or application accessibility, or some other undesirable event. 
The dialog box is presented before the action is performed and offers 
the user the opportunity to cancel the requested operation. The 
buttons displayed are Yes, No, and Help, or Continue, Cancel, and 
Help. Help provides additional information on the consequences of 
performing the action requested.—_page 244 


The use of Yes and No or Continue and Cancel depends on the 
wording of your message. The labels for Yes and No should be 
replaced as suggested previously. Continue may be replaced with a 
label more specific to the action that will be performed. 
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gp: 


A working dialog box is used to display in-progress information to the 
user when this information is not displayed in the footer of your 
application's window. The dialog box contains a Stop button that 
allows the user to terminate the activity. The operation is terminated 
at the next appropriate breakpoint, and a confirmation might be 
displayed asking whether the user really wants to stop the activity. 
The confirmation message might state the consequences of stopping 
the action.—page 245 


Work-in- Progress Feedback 


Recommended 


Recommended 


Recommended 


gt: 


gu: 


gv: 


If any command chosen by the user is expected to take longer than 2 
seconds to complete, but less than 10 seconds, your application 
displays the standard busy pointer as feedback that the command is 
executing.—page 246 


The user must receive assurance that your application has “heard” 
the request and is working on it. If the results of the request cannot 
be displayed immediately, some feedback must be provided. The busy 
cursor should be displayed within 0.5 seconds of execution of the 
command. 


If any command chosen by the user is expected to take longer than 10 
seconds to complete, your application displays a working dialog box or 
other feedback of similar character that indicates that the application 
is working on the request. The feedback should reveal progress 
toward completion of the activity. page 246 


If an activity is expected to take a significant amount of time (10 
seconds or more), your application should display feedback stronger 
than the busy pointer. Displaying the busy pointer for long amounts 
of time may lead the user to conclude that the application has become 
“nung.” A progress indicator should be displayed in these scenarios 
that indicates that the application is still functioning and is working 
on the user's request. The progress indicator should show how much 
of the activity has been completed and what amount remains. 


When your application displays work-in-progress feedback to the user, 
it does not block access to other applications and services within the 
desktop environment.—page 246 
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Multitasking should always be supported and thus your application 
should allow the user to access other services while it is busy 
performing some activity. Preferably, the user is also able to access 
other features within your application even though it is currently 
working on another request. When this is supported, your application 
should display an enhanced busy pointer that indicates that the 
application is busy but still willing to accept input. 
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Designing forAcc essibility 9 


This chapter provides guidelines for making software applications 
accessible to people with disabilities. 


Accessibility means removing barriers that can prevent people with 
disabilities from participating in substantial life activities, including the 
use of services, products, and information. 


Removing barriers to access often results in benefits for a wide range of 
people—not only those with disabilities. For example, until curb cut ramps 
were placed on sidewalks, it was difficult or impossible for people in 
wheelchairs to cross a street. |n addition to providing a wheelchair 
solution, curb cuts have benefited people on bicycles, as well as those 
pushing shopping carts and baby carriages. 


Designing accessible software has similar beneficial consequences for a 
wide range of users. Solutions that allow use of the keyboard instead of the 
mouse aid users involved in keyboard-intensive tasks. Users of portables or 
those in open offices with telephones ringing may not be able to use or hear 
sounds. Providing visual cues to augment or replace audible cues assists 
these users, in addition to assisting hearing impaired users. 
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There is a growing market for accessible computer products. Approximately 
40 million Americans have a disability of some type, and as the population 
ages, more and more people will develop age-related disabilities (25% by 
age 55, jumping to 50% at age 65). 


Like all computer users, users with disabilities vary in age, computer 
experience, interests, and education. When barriers are removed, the 
computer gives them a tool to compete with all other users on an equal 
basis. Users with disabilities are engineers, artists, scientists, designers, 
lawyers, administrative assistants, and software engineers. The common 
thread among these diverse users is that computers play an important role 
in their daily work. 


Not only does providing access provide benefits for a wide range of users, 
but it is also a requirement in all current federal contracts under section 
508 of the Federal Rehabilitation Act. In the commercial sector, the 
Americans with Disabilities Act (ADA) calls for similar considerations when 
reasonably accommodating current and prospective employees. 


Accessand the Style Guide 


Physic al Disabilities 


Many users with disabilities can use application software without any 
adjunct adaptive software or hardware, while others may use additional 
technology such as screen readers or speech recognition. In either case, it is 
important to follow required style guidelines because those guidelines 
provide standard methods that make it possible for users with disabilities 
to access applications either directly or through adaptive software and 
hardware. 


The easiest way to ensure accessible applications is to follow the style 
guidelines, and to read and follow the advice offered in this chapter. 


Physical disabilities can be the result of congenital conditions, accidents, or 
excessive muscular strain. Examples include spinal cord injuries, 
degenerative nerve diseases, stroke, and repetitive stress injuries. 
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Guideline 


Recommended 


Visual Disabilities 


While physical capabilities vary greatly between and within the disability 
examples cited, they have a common requirement for keyboard access to all 
controls, features, and information in application software. Providing 
comprehensive keyboard access is essential to ensure that the user who 
cannot utilize a mouse can productively use Motif applications. 


Full keyboard access to an application is necessary, but not sufficient to 
make applications accessible. The other central requirement is to follow the 
key mapping guidelines found throughout this style guide. Consistent use 
of these mappings not only provides more usable applications for all users 
by reducing learning across applications, but also increases the 
effectiveness of alternate |/O technology such as speech control and screen 
reading software. 


id: All application functions are accessible from the keyboard.—page 267 


Visual disabilities may require use of tools ranging from reading glasses, to 
large-sized displays and fonts, to screen reading software that enables 
completely blind users to navigate and hear what is on the screen. 


Reading small fonts can be challenging for users with low vision. All fonts, 
including those in text panes, menus, labels, and information messages 
should be easily configurable by the user—font size and type should never 
be hard coded. 


Interpreting information that depends upon color (for example, red = stop, 
green = go) can be difficult for people with visual impairments. A 
significant number of people are color blind and are unable to see 
differences between some colors. For these reasons, never use color as the 
only source of information. 


In addition to being difficult to interpret, some background and text color 
combinations can result in text that is difficult to read for users with visual 
impairments. Again, the key is to provide choice. Never hard code color 
choices. Users should always have the capability to override default colors, 
so they can choose the colors that work best for them. 
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Guidelines 
Recommended 


Recommended 


Recommended 


Recommended 


Hearing Disabilities 


Provide meaningful names for every widget instance. Meaningful names 
help screen reading software give useful information to users with visual 
impairments. Rather than naming an eraser graphic widget5, for example, 
call it eraser or some other such descriptive name. 


Without such descriptive information, blind or low-vision users cannot 
interpret unlabeled, graphically labeled, or custom widgets. Providing this 
information is a requirement for access in such cases. As an added bonus, 
meaningful widget names make for code that is easier to debug. 


Finally, remember that many users with visual disabilities depend upon 
keyboard navigation and control, and they will not be using a pointing 
device. 


ie: Colors should not be hard coded.—page 267 


if: | Graphic attributes, such as line, border, and shadow, should not be 
hard coded.—page 267 


ig: Font sizes and styles should not be hard coded.—page 267 


ih: All application code uses descriptive names for widgets. Such 
descriptive names for widgets using graphics instead of text (for 
example, palette items and icons) allow screen reading software to 
provide descriptive information to blind users.—page 267 


People with hearing disabilities either cannot detect sound or may have 
difficulty distinguishing audio output from typical background noise. 


Never assume that users will hear an auditory notice. Remember that 
users sitting in airplanes, in noisy offices, or in other public places where 
sound must be turned off need the same types of visual notification as 
hearing impaired users. Additionally, some users are able to hear audible 
cues only at certain frequencies or volumes. Volume and frequency of audio 
feedback should be easily configurable by the user. Never hard code these 
parameters. 
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Sounds unaccompanied by visual notification, such as a beep indicating 
that a print job is complete, are of no value to users with hearing 
impairments or others who are not using sound. While such sounds can be 
valuable, never create a design that assumes sounds will be heard. 


On the other hand, it would be intrusive for most users to see a warning 
window whenever a printout is ready. Visual notices can take the form of 
changing an icon, posting a message in an information area, or providing a 
message window as appropriate. Anyone using a system in a public area 
will benefit from the option of choosing to see rather than hear such 
notices. 


The key point is to provide users with a choice. When appropriate, provide 
visual as well as audio notification. If visual notification does not make 
sense as the default behavior, then be sure to provide it as an option. 


Guidelines 


Recommended ii: Interactions do not depend upon the assumption that a user will hear 
an audible notification.—page 267 


Recommended ij: Where appropriate, users can choose to receive cues as audio or visual 
information.—page 267 


Recommended ik: The application does not overuse or rely exclusively on audible 
information.—page 267 


Recommended il: Users can choose to configure the frequency and volume of audible 
cues.—page 267 


Language, Cognitive, and Other Disabilities 


The access guidelines outlined for visual, hearing, and physical disabilities 
typically benefit users with cognitive, language, and other disabilities by 
allowing them to choose effective means of communication, sometimes 
through the use of adaptive technology. 
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Guidelines 


Recommended im: Tear-off menus and user configurable menus for key application 
features may be provided for users with language and cognitive 
disabilities.—page 268 


Existing Keyboard Access Features 


When designing CDE Motif applications, be aware of existing system-level 
key mappings used by access features in the X Window System™ server. 
These server features, known as AccessX, provide basic workstation 
accessibility, typically used by people with mobility impairments. Accessx 
became a supported part of the X Windows server in version X11R6. 


The built-in, server-level access features include: 


StickyKeys Provides locking or latching of modifier keys (for 
example, Shift, Control) so that they can be used 
without simultaneously pressing the keys being 
modified. StickyK eys allow single-finger operation of 
multiple key combinations. 


RepeatKeys Delays the onset of key repeat, allowing users with 
limited coordination time to release keys before 
multiple characters are sent. 


SlowKeys Requires a key to be pressed and held for a set 
period before keypress acceptance. This allows 
users with limited coordination to accidentally press 
keys without sending keypress events. 


MouseKeys An alternative to the mouse which provides 
keyboard-based explicit control of cursor movement 
and all mouse button press and release events. 


ToggleKeys Indicates locking key state with a tone when 
pressed; for example, Caps Lock. 


BounceKeys Requires a delay between keystrokes before 
accepting the next keypress so users with tremors 
can prevent the system from accepting inadvertent 
keypresses. 
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Guideline 


Recommended in: Application keymappings do not conflict with existing system-level 
key mappings reserved for access features in the X Windows server as 
shown in Table 10-6.—page 268 


Resources for More Information on Accessibility 


For more information about software accessibility, consult the following 
organizations, conferences, and books. 


Organizations 


Clearinghouse on Computer Accommodation (COCA) 
18th & F Streets, NW 

Room 1213 

Washington, DC 20405 

(202) 501-4906 


A central clearinghouse of information on technology and accessibility. 
COCA documentation covers products, government resources, user 
requirements, legal requirements, and much more. 


Sensory Access Foundation 
385 Sherman Avenue, Suite 2 
Palo Alto, CA 94306 

(415) 329-0430 


A nonprofit organization that consults on application of technology "to 
increase options for visually and hearing impaired persons." Publishes 
newsletters on adaptive technology. 


Special Needs Project 
3463 State Street 

Santa Barbara, CA 93105 
(805) 683-9633 


Vendor of books for professionals and families on a wide variety of 
disability issues. 
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Trace Research and Development Center 
S-151 Waisman Center 

1500 Highland Avenue 

Madison, WI 53528 

(608) 262-6966 


A central source for the current information on assistive technologies as 
well as a major research and evaluation center. Trace distributes 
databases and papers on adaptive technology and resources. 


Conferences 


CSUN 

Conference on Technology and Persons with Disabilities 
Every spring in Los Angeles, California 

(818) 885-2578 


Closing the Gap 

Conference on Microcomputer Technology in Special Education and 
Rehabilitation 

Every fall in Minneapolis, Minnesota 

(612) 248-3294 
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Partt2 — CertficationChecklist 


Certific ationC hec klist 10= 


The Common Desktop Environment Certification Checklist provides the list 
of requirements for Common Desktop Environment application-level 
certification. Common Desktop Environment requirements consist of the 
OSF/Motif Release 1.2 requirements with Common Desktop Environment- 
specific additions. 


How to Use the Checklist 


You certify your own application by comparing its behavior with that 
specified in the checklist. For each checklist item, check Yes only if your 
application performs exactly as described for that item. If you have not 
implemented a specified type of behavior in any manner anywhere in your 
application, check N/A (not applicable) for the items pertaining to that 
behavior. 


The checklist describes keys using a model keyboard mechanism. Wherever 
keyboard input is specified, the keys are indicated by the engravings that 
they have on the OSF/Motif model keyboard. Mouse buttons are described 
using a virtual button mechanism to better describe behavior independent 
from the number of buttons on the mouse. For more information on the 
model keyboard and virtual button mechanisms, consult the Preface and 
Section 2.2.1, “Pointing Devices” of the OSF/ Motif Style Guide Revision 
1.2. 
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Preface 


154 


y 


n/a 


n 


Note - This checklist uses Common Desktop Environment typographical 
conventions for keyboard and mouse inputs. These conventions differ from 
those used in the OSF/ Motif Style Guide, Revision 1.2. For information, 
see“What Typographic Changes and Symbols Mean” on page xxvi. 


By default, this checklist assumes that your application is being designed 
for a left-to-right language environment in an English-language locale. 
Some sections of the checklist may require appropriate changes for other 
locales. 


As you compare the behavior of your application to the requirements in the 
checklist, we recommend that you follow along in the OSF/ Motif Style 
Guide, Revision 1.2. Each item in this checklist contains the corresponding 
section number from the OSF /Motif checklist, if the item came from that 
list. Each item in the checklist is also followed by a brief explanation or 
justification. If you do not understand a particular item, refer to the 
appropriate section in the OSF/Motif guide and check the glossary for any 
terms that are unclear. 


The headings used in this checklist correspond to the headings in the 
OSF/ Motif Style Guide Revision 1.2 and the checklist items are labeled 
with the numbers used in that book. The Common Desktop Environment- 
specific additions are labeled with alphabetic identifiers. 


Each checklist item also has a priority label: Required, Recommended, or 
Optional. The Required items must be followed for an application to be 
Common Desktop Environment compliant. Recommended items should be 
followed where feasible. Optional items are alternative implementations 
which the interface designer can choose. 


Required O O © 1-1: Each of the nonoptional keys described on the OSF/Motif model 


keyboard is available either as specified or by using other keys or key 
combinations if the specified key is unavailable (Preface). 


The model keyboard does not correspond directly to any existing 
keyboard; rather, it assumes a keyboard with an ideal set of keys. 
However, to ensure consistency across applications, the nonoptional 
keys or substitutes for them must always be available. 
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Input Models 


Keyboard Focus Model 


y n/aon 
Required O O O 21: 


Required O O O 2-2: 


Required O O O 2:3: 


Only one window at a time has the keyboard focus. The window that 
has the focus is highlighted. Within the window that has the 
keyboard focus, only one component at a time has the focus. 


The keyboard focus determines which component on the screen 
receives keyboard events. This rule prevents confusion about which 
window and component have the focus. 


When your application uses an explicit focus policy, pressing BSelect 
does not move focus to a component that is not traversable or does not 
accept input. 


An explicit focus policy requires the user to explicitly select which 
window or component receives the keyboard focus. Generally, the user 
gives the focus to a window or component by pressing BSelect over it. 
However, this policy must not allow the user to give focus toa 
component that is not traversable or does not accept input. 


When your application uses an explicit focus policy, the component 
with the keyboard focus is highlighted by a location cursor. 


The user needs to know the location of the keyboard focus to be able 
to control an application. 


Input Device Model 


Required O O O 2-4: 


Required O O O 


2-5: 


Your application supports methods of interaction for keyboard-only 
users. All features of your application are available from the 
keyboard. 


Some users may not have access to a pointing device. These users 
need to be able to access the full functionality of the application from 
the keyboard. Additionally, advanced users will be able to use the 
keyboard to perform some tasks more quickly than with a pointing 
device. 


Your application uses the following bindings for mouse buttons: 
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y nan 
Required O O O 2-6: 


Required O O O @ 


Required O O O 


Required O O O 


BSelect Used for selection, activation, and setting the location 
cursor, and is the leftmost button, except for left- 
handed users, where it can be the rightmost button. 


BTransfer Used for moving and copying elements, and is the 
middle mouse button, unless dragging is integrated 
with selection or the mouse has fewer than three 
buttons. 


BMenu Used for popping up menus, and is the rightmost 
button, except for left-handed users, where it can be 
the leftmost button, or unless the mouse has fewer 
than three buttons. If the mouse has one button, 
BMenu is bound to Alt+B Select. 


These bindings ensure a consistent interface for using standard 
mouse-based operations across applications. 


Your application does not warp the pointer unless you have given the 
user a means of disabling the behavior. 


The pointer position is intended only as input to applications, not as 
an output mechanism. An application warps the pointer when it 
changes the pointer’s position. This practice is confusing to users and 
reduces their sense of control over an application. Warping the 
pointer can also cause problems for users of absolute location pointing 
devices. 


Components and applications that have functions corresponding to 
the Motif/Common Desktop Environment virtual keys must support 
those keys. 


If these virtual keys are available, the following mappings should be 
used. Priorities indicate the importance of implementing these 
functions in your application. 


Help =F1 Pressing the Help key provides the user with help 
information in a window or in the status area. 


Properties = Control-H 
Pressing the Properties key invokes a dialog box for 
making object-specific settings. 
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y nia 
Required O O 


Optional O O 


Required O O 


Optional O O 


Required O O 


Optional O O 


Required O O 


=) 


Undo = Control+Z 
Pressing the Undo key reverses the effect of the last 
applied operation. This is the primary key mapping for 
Undo. 


Undo = Alt+Backspace 
This is a secondary key mapping for Undo. It should 
be supported in addition to Control +Z to help users 
migrating from previous versions of Motif, Microsoft 
Windows, or OS/2. 


Cut = Control +X 
Pressing the Cut key removes the selected object and 
places it in the clipboard. This is the primary key 
mapping for Cut. 


Cut =Shift+Delete 
This is a secondary key mapping for Cut. It should be 
supported in addition to Control +X to help users 
migrating from previous versions of Motif, Microsoft 
Windows, or OS/2. 


Copy =Control+C 
Pressing the Copy key places a copy of the selected 
object in the clipboard. This is the primary key 
mapping for Copy. 


Copy =Control-+Hnsert 
This is a secondary key mapping for Copy. It should be 
supported in addition to Control+C to help users 
migrating from previous versions of Motif, Microsoft 
Windows, or OS/2. 


Paste =Control+V 
Pressing the Paste key places the contents of the 
clipboard at the selected location. This is the primary 
key mapping for Paste. 
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Optional O O 


Optional O O 


Optional O O 
Optional O O 
Optional O O 
Optional O O 


Optional O O 


Navigation 


Paste = Shift-Hnsert 
This is a secondary key mapping for Paste. It should 
be supported in addition to Control-V to help users 
migrating from previous versions of Motif, Microsoft 
Windows, or OS/2. 


Open = Control+O 
Pressing the Open key opens the object, which is 
typically the default action. 


Stop = Control+S 
Pressing the Stop key cancels an operation. 


Again = Control+A 
Pressing the Again key repeats the last operation. 


Print = Control+P 
Pressing the Print key initiates printing. 


Save = Control+S 
Pressing the Save key saves the current file. 


New =Control+N 
Pressing the New key will create a new object. 


Mouse-Based Navigation 


Required O O © 3-1: When the keyboard focus policy is explicit, pressing BSelect on a 
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component moves focus to it, except for components, such as scroll 
bars, that are used to adjust the size and location of other elements. 


BSelect provides a convenient mechanism for using the mouse to 
move focus when the keyboard focus policy is explicit. 
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Required O O O 32: 


Required O O O 33: 


Required O O O 


Required O O O 


Required O O O 


Required O O O 


3-4: 


3-5: 


3-6: 


3-7: 


When the pointer is on a menu, your application uses BSelect Press to 
activate the menu in a spring-loaded manner. 


A spring-loaded menu is one that appears when the user presses a 
mouse button, remains on the screen for as long as the button is 
pressed, and disappears when the user releases the button. BSelect, 
mouse button 1, provides a means of activating spring-loaded menus 
that is consistent across applications. 


When the pointer is in an element with an inactive pop-up menu and 
the context of the element allows the pop-up menu to be displayed, 
your application uses BMenu Press to activate the pop-up menu in a 
spring-loaded manner. 


The availability of a pop-up menu can depend on the location of the 
pointer within an element, the contents of an element, or the selection 
state of an element. BMenu, mouse button 3, provides a consistent 
means of activating a spring-loaded pop-up menu. 


If the user takes an action to post a pop-up menu, and a menu can be 
posted for both an inner element and an outer element that contains 
the inner element, the pop-up menu for the internal element is 
posted. 


This specification ensures that the pop-up menu for an internal 
element is always accessible. 


Once a pop-up menu is posted, BMenu behaves just as BSelect does 
for any menu system. 


The specified operation of BMenu is for manipulating pop-up menus. 


BSelect is also available from within posted pop-up menus and 
behaves just as in any menu system. 


Once a pop-up menu is posted, the user can select an element from it 
using the standard selection mechanism, B Select. 


When a menu is popped up or pulled down in a posted manner, your 
application places the location cursor on the menu's default entry, or 
on the first entry in the menu if there is no default entry. 
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Required O O O 38: 


Required O O O 39: 


Required O O O 3-10: 


Required O O O S11: 


Required O O O 312: 


A posted menu remains visible until it is explicitly unposted. Placing 
the location cursor on the default entry allows the user to select the 
default operation easily. When there is no default entry, placing the 
location cursor on the first entry yields uniform behavior across 
applications. 


Your application removes a spring-loaded menu system when the 
mouse button that activated it is released, except when the button is 
released on a cascading button in the menu hierarchy. 


The concept of a spring-loaded menu system requires that the menu 
disappear when the mouse button is released. 


While a spring-loaded menu system is popped up or pulled down, 
moving the pointer within the menu system moves the location cursor 
to track the pointer. 


Once a spring-loaded menu system has appeared on the screen, the 
user needs to be able to maneuver the location cursor through the 
menu system using the mouse. 


When a spring-loaded menu system is popped up or pulled down and 
the pointer rests on a cascading button, the associated menu is pulled 
down and becomes traversable. The associated menu is removed, 
possibly after a short delay, when the pointer moves to a menu item 
outside of the menu or its cascading button. 


The user needs to be able to use the mouse to access all of the 
associated menus of a menu system. This feature allows the user to 
move quickly to any menu in a menu system. 


When a spring-loaded menu system that is part of the menu bar is 
pulled down, moving the pointer to any other element on the menu 
bar unposts the current menu system and posts the pull-down menu 
associated with the new element. 


This feature of a spring-loaded menu system allows the user to 
browse quickly through all of the menus attached to a menu bar. 


When a spring-loaded menu system is popped up or pulled down, and 
the button that activated the menu system is released within a 
component in the menu system, that component is activated. If the 
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y nan 
Required O O O 313: 


Required O O O 314: 


Required O O O 315: 


Required O O O 3-16: 


Optional O O O DB: 
Required O O O ¢: 


release is on a cascading button or an option button, the associated 
menu is activated in a posted manner if it was not posted prior to the 
associated button press. 


Releasing the mouse button that activated a spring-loaded menu 
provides a means of activating a menu element that is consistent 
across applications. 


When the pointer is in an area with a pop-up menu, your application 
uses BMenu Click to activate the menu in a posted manner if it was 
not posted prior to the BMenu Click. 


BMenu Click provides a means of posting a pop-up menu that is 
consistent across applications. 


Once a pull-down or option menu is posted, BSelect Press in the menu 
system causes the menu to behave as a spring-loaded menu. 


This feature of a posted pull-down or option menu allows the user to 
switch easily between using a posted menu and a spring-loaded menu. 


If a button press unposts a menu and that button press is not also 
passed to the underlying component, subsequent events up to and 
including the button release are not passed to the underlying 
component. 


When a button press unposts a menu, the press can be passed to the 
underlying component. Whether or not it is passed to the underlying 
component, the press can have additional effects, such as raising and 
giving focus to the underlying window. If the press is not passed to 
the underlying component, events up to and including the release 
must not be passed to that component. 


Once a pop-up menu is posted, BSelect Press or BMenu Press in the 
menu system causes the menu to behave as a spring-loaded menu. 


This feature of a posted pop-up menu allows the user to switch easily 
between using a posted menu and a spring-loaded menu. 


BMenu Press or BMenu Click on a menu bar item displays the menu. 


BMenu Press or BMenu Click on an option button displays the option 
menu. 
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162 


Required O O O @: 


BSelect Press on a text field causes the text cursor to be inserted at 
the mouse cursor position. 


Keyboard-Based Navigation 


y nia 
Required O O 


Required O O 


Required O O 


Required O O 


Required O O 


3-17: 


3-18: 


3-19: 


3-20: 


3-21: 


In a text component, the text cursor is shown differently when the 
component does and does not have the keyboard focus. 


In atext component, the text cursor serves as the location cursor and, 
therefore, must indicate whether the component has keyboard focus. 


If a text component indicates that it has lost the keyboard focus by 
hiding the text cursor and if the component subsequently regains the 
focus, the cursor reappears at the same position it had when the 
component lost focus. 


To ensure predictability, it is important that the text cursor not 
change position when a text component loses and then regains the 
keyboard focus. 


If a small component, such as a sash, indicates that it has the 
keyboard focus by filling, no other meaning is associated with the 
filled state. 


This rule reduces possible confusion about the significance of filling in 
a small component. 


All components are designed and positioned within your application 
so that adding and removing each component's location cursor does 

not change the amount of space that the component takes up on the 
screen. 


For visual consistency, the sizes and positions of components should 
not change when keyboard focus moves from one component to 
another. 


Control+Tab moves the location cursor to the next field, and 
Control+Shift+Tab moves the location cursor to the previous field. 
Unless Tab and Shift+Tab are used for internal navigation within a 
field, Tab also moves the location cursor to the next field, and 
Shift+Tab also moves the location cursor to the previous field. 
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Required O O O 322: 


y n/aon 
Required O O O 323: 


Required O O O 3-24: 


These keys provide a consistent means of navigating among fields in a 
window. 


Tab (if not used for internal navigation) and Control+Tab move the 
location cursor forward through fields in a window according to the 
following rules: 


© |f the next field is a control, Tab (if not used for internal 
navigation) and Control+Tab move the location cursor to that 
control. 


e Ifthe next field is a group, Tab (if not used for internal navigation) 
and Control+Tab move the location cursor to a traversable 
component within the group. 


¢ If the next field contains no traversable components, Tab (if not 
used for internal navigation) and Control+Tab skip the field. 


These rules ensure the consistent operation of Tab (if not used for 
internal navigation) and Control+Tab across applications. 


Shift+Tab (if not used for internal navigation) and Control +Shift+Tab 
move the location cursor backward through fields in the order 
opposite to that of Tab (if not used for internal navigation) and 
Control +Tab. 


These rules result in the uniform operation of Shift+Tab (if not used 
for internal navigation) and Control +Shift+Tab across applications. 


When a window acquires focus, the location cursor is placed on the 
control that last had focus in the window, providing that all the 
following conditions are met: 


* The window uses an explicit keyboard focus policy. 


® The window acquires the focus through keyboard navigation or 
through a button press other than within the client area of the 
window. 


* The window had the focus at some time in the past. 


¢ The control that last had focus in the window is still traversable. 


This rule ensures that when the user returns to a window after 
navigating away, the focus returns to the component where the user 
left it. 
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Required O O O 325: 


Required O O O 3-26: 


y nan 
Required O O O 327: 


Field navigation wraps between the first and last fields in the 
window. 


This feature of field navigation provides the user with a convenient 
way to move through all of the fields in a window. 


When the Down Arrow and Up Arrow keys are used for component 
navigation within a field, they behave according to the following 
rules: 


In a left-to-right language environment, the Down Arrow key moves 
the location cursor through all traversable controls in the field, 
starting at the upper left and ending at the lower right, then 
wrapping to the upper left. If the controls are aligned in a matrix-like 
arrangement, Down Arrow first traverses one column from top to 
bottom, then traverses the column to its right, and so on. In a right- 
to-left language environment, Down Arrow moves the location cursor 
through all traversable controls, starting at the upper right and 
ending at the lower left. 


© Up Arrow moves the location cursor through all traversable 
controls in the field in the order opposite to that of Down Arrow. 


These rules ensure a consistent means of navigating among 
components using the directional keys. 


When the Right Arrow and Left Arrow keys are used for component 
navigation within a field, they behave according to the following 
rules: 


© Inaleft-to-right language environment, the Right Arrow moves the 
location cursor through all traversable controls in the field, 
starting at the upper left and ending at the lower right, then 
wrapping to the upper left. If the controls are aligned in a matrix- 
like arrangement, the Right Arrow first traverses one row from left 
to right, then traverses the row below it, and so on. In a right-to- 
left language environment, the Right Arrow moves the location 
cursor through all traversable controls, starting at the lower left 
and ending at the upper right. 


¢ Left Arrow moves the location cursor through all traversable 
controls in the field in the order opposite to that of the Right 
Arrow. 


CDE: Style Guide and Certification Checklist 


10= 


Required O O O 328: 


y n/a n 
Required O O O 3-29: 


Required O O O 3-30: 


Required O O O 331: 


These rules ensure a consistent means of navigating among 
components using the directional keys. 


If a control uses the Right Arrow and Left Arrow for internal 
navigation, Begin moves the location cursor to the leftmost edge of 
the data or the leftmost element in a left-to-right language 
environment. In a right-to-left language environment, Begin moves 
the location cursor to the rightmost edge of the data or the rightmost 
element. 


This rule permits convenient navigation to the left or right edge of the 
data or the left or right element in a control. 


If a control uses the Right Arrow and Left Arrow keys for internal 
navigation, the End key moves the location cursor to the rightmost 
edge of the data or the rightmost element in a left-to-right language 
environment. In a right-to-left language environment, End moves the 
location cursor to the leftmost edge of the data or the leftmost 
element. 


This rule permits convenient navigation to the left or right edge of the 
data or the left or right element in a control. 


If a control uses the Up Arrow and Down Arrow keys for internal 
navigation, Control-+Begin moves the location cursor to one of the 
following: 


¢ The first element 
© The topmost edge of the data 


© Ina left-to-right language environment, the topmost left edge of 
the data; in a right-to-left language environment, the topmost right 
edge of the data 


This rule permits convenient navigation to the beginning of the data 
in a control. 


If a control uses the Up Arrow and Down Arrow keys for internal 
navigation, Control-+End moves the location cursor to one of the 
following: 
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Optional O O O & 


Required O O O Ff: 


y n/aon 
Required O O O & 


Optional O O O hi: 


Menu Traversal 


Required O O O 332: 


Required O O O 333: 


Required O O O 3-34: 


© The last element 
* The bottommost edge of the data 


© Ina left-to-right language environment, the bottommost right edge 
of the data; in a right-to-left language environment, the 
bottommost left edge of the data 


This rule permits convenient navigation to the end of the dataina 
control. 


Each time a new window is opened, keyboard focus is placed in the 
first field or location within the window or in a default location, if this 
is appropriate for the particular window. 


The Tab key moves input focus between push buttons within a group. 


The arrow keys also move the selected focus per the OSF/ Motif Style 
Guide Revision 1.2. 


Use the Control, Shift, and Alt keys only to modify the function of 
other keys or key combinations. 


Use the Alt key only to provide access to mnemonics. 


If the user traverses to a menu while the keyboard focus policy is 
implicit, the focus policy temporarily changes to explicit and reverts 
to implicit whenever the user traverses out of the menu system. 


Menus must always be traversable, even when the keyboard focus 
policy is generally implicit. 


Your application uses the F10 key to activate the menu bar system if 
it is inactive. The location cursor is placed on the first traversable 
cascading button in the menu bar. If there are no traversable 
cascading buttons, the key does nothing. 


F10 provides a consistent means of traversing to the menu bar using 
the keyboard. 


When the keyboard focus is in an element with an inactive pop-up 
menu and the context of the element allows the pop-up menu to be 
displayed, your application uses the menu key to activate the pop-up 
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Required O O O 3-35: 


y nia 
Required O O 


Required O O 


Required O O 


Required O O 


3-36: 


3-37: 


3-38: 


3-39: 


menu. The location cursor is placed on the default item of the menu, 
or on the first traversable item in the pop-up menu if there is no 
default item. 


The Menu key provides a uniform way of activating a pop-up menu 
from the keyboard. 


When the keyboard focus is in an option button, your application uses 
the Select key or the Spacebar to post the option menu. The location 
cursor is placed on the previously selected item in the option menu; 
or, if the option menu has been pulled down for the first time, the 
location cursor is placed on the default item in the menu. If there is 
an active option menu, the Return, Select, or Spacebar keys select the 
current item in the option menu, unpost the menu system, and return 
the location cursor to the option button. 


These keys provide a means of posting an option menu from the 
keyboard that is consistent across applications. 


Your application uses the Down Arrow, Left Arrow, Right Arrow, and 
Up Arrow keys to traverse through the items in a menu system. 


The Down Arrow, Left Arrow, Right Arrow, and Up Arrow directional 
keys provide a consistent means of navigating among items in a menu 
system. 


When a menu traversal action traverses to the next or previous 
component in a menu or menu bar, the order of traversal and the 
wrapping behavior are the same as that of the corresponding 
component navigation action within a field. 


This specification provides consistency between menu traversal and 
component navigation within a field. 


If your application uses any two-dimensional menus, they do not 
contain any cascading buttons. 


Cascading buttons in a two-dimensional menu would restrict the 
user’s ability to navigate to all of the elements of the menu using the 
keyboard. 


When focus is on a component in a menu or menu bar system, the 
Down Arrow key behaves in the following way: 
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Required O O O 3-40: 


y nan 
Required O O O S41: 


e |f the component is in a vertical or two-dimensional menu, traverse 
down to the next traversable component, wrapping within the 
menu if necessary. 


e |f the component is in a menu bar, and the component with the 
keyboard focus is a cascading button, post its associated pull-down 
menu and traverse to the default entry in the menu or, if the menu 
has no default, to the first traversable entry in the menu. 


This rule results in consistent operation of the directional keys in a 
menu or menu bar system. 


When focus is on a component in a menu or menu bar system, the Up 
Arrow key behaves in the following way: 


If the component is in a vertical or two-dimensional menu, this action 
traverses up to the previous traversable component, wrapping within 
the menu if necessary, and proceeding in the order opposite to that of 
the Down Arrow key. 


This rule results in consistent operation of the directional keys in a 
menu or menu bar system. 


When focus is on a component in a menu or menu bar system, the 
Left Arrow key behaves in the following way: 


e |f the component is in a menu bar or two-dimensional menu, but 
not at the left edge, traverse left to the previous traversable 
component. 


e |f the component is at the left edge of a menu bar, wrap within the 
menu bar. 


e |f the component is at the left edge of a vertical or two-dimensional 
menu that is the child of a vertical or two-dimensional menu, 
unpost the current menu and traverse to the parent cascading 
button. 


e |f the component is at the left edge of a vertical or two-dimensional 
menu that is the child of a menu bar, unpost the current menu and 
traverse left to the previous traversable entry in the menu bar. If 
that entry is a cascading button, post its associated pull-down 
menu and traverse to the default entry in the menu or, if the menu 
has no default, to the first traversable entry in the menu. 
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Required O O O 3-42: 


y n/aon 
Required O O O 3-43: 


Required O O O 3-44: 


This rule results in consistent operation of the directional keys in a 
menu or menu bar system. 


When focus is on a component in a menu or menu bar system, the 
Right Arrow key behaves in the following way: 


e |f the component is a cascading button in a vertical menu, post its 
associated pull-down menu and traverse to the default entry in the 
menu or, if the menu has no default, to the first traversable entry 
in the menu. 


e |f the component is in a menu bar or two-dimensional menu, but 
not at the right edge, traverse right to the next traversable 
component. 


e |f the component is at the right edge of a menu bar, wrap within 
the menu bar. 


© |f the component is not a cascading button and is at the right edge 
of a vertical or two-dimensional menu, and if the current menu has 
an ancestor cascading button (typically in a menu bar) from which 
the Down Arrow key posts its associated pull-down menu, unpost 
the menu system pulled down from the nearest such ancestor 
cascading button and traverse right from that cascading button to 
the next traversable component. If that component is a cascading 
button, post its associated pull-down menu and traverse to the 
default entry in the menu or, if the menu has no default, to the 
first traversable entry in the menu. 


This rule results in consistent operation of the directional keys in a 
menu or menu bar system. 


All menu traversal actions, with the exception of menu posting, 
traverse to tear-off buttons in the same way as for other menu 
entries. 


Traversal of tear-off buttons needs to be consistent with traversal of 
other menu items. 


If your application uses the F10, Menu, or Cancel key to unpost an 
entire menu system and an explicit focus policy is in use, the location 
cursor is moved back to the component that had it before the menu 
system was posted. 
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Returning the location cursor to the component that had it previously 
allows the user to resume a task without disruption. 


Sc rollable Component Navigation 


Required O O O 3-45: 


Required O O O 3-46: 


y nan 
Required O O O 3-47: 


Required O O O 3-48: 


Selection 


Any scrollable components within your application support the 
appropriate navigation and scrolling operations. Your application uses 
the page navigation keys Page Up, Page Down, Control+Page Up (for 
Page Left), and Control+Page Down (for Page Right) for scrolling the 
visible region by a page increment. 


A user needs to be able to view and access the entire contents of a 
scrollable component. 


When scrolling by a page, your application leaves at least one unit of 
overlap between the old and new pages. 


The overlap between one page and the next yields visual continuity 
for the user. 


Any keyboard operation that moves the cursor to or in the component, 
or that inserts, deletes, or modifies items at the cursor location scrolls 
the component so that the cursor is visible when the operation is 
complete. 


The user needs to be able to see the results of moving the location 
cursor or operating on the contents of the scrollable component. 


If a mouse-based scrolling action is in progress, the Cancel key 
cancels the scrolling action and returns the scrolling device to its 
state prior to the start of the scrolling operation. 


The Cancel key provides a convenient way for the user to cancel a 
scrolling operation. 


Selection Models 


Required O O O #1: 


Your system supports five selection models: single selection, browse 
selection, multiple selection, range selection, and discontiguous 
selection. 
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Each collection has one or more appropriate selection models. The 
model limits the kinds of choices the user can make in the collection. 
Some collections enforce a selection model, while others allow the 
user or application to change it. 


Mouse-Based Single Selection 


Required O O O 42: 


In a collection that uses single selection, when BSelect is clicked ina 
deselected element, the location cursor moves to that element, that 
element is selected, and any other selection in the collection is 
deselected. 


Single selection is the simplest selection model, used to select a single 
element. BSelect, the first mouse button, provides a consistent means 
of selecting an object within a group using the mouse. 


Mouse- Based Browse Selection 


y nan 
Required O O O 43: 


4-4: 


In a collection that uses browse selection, when BSelect is released in 
a selectable element, that element is selected, and any other selection 
in the collection is deselected. As BSelect is dragged through 
selectable elements, each element under the pointer is selected, and 
the previously selected element is deselected. The selection remains 
on the element where BSelect is released, and the location cursor is 
moved there. 


Browse selection is used to select a single element. It also allows the 
user to browse through the collection by dragging BSelect. See 
“Mouse-Based Multiple Selection” on page 171. 


This item has been deleted. 


Mouse- Based Multiple Selection 


Required O O O FE: 


If your application contains collections that follow the multiple 
selection model, BAdjust is supported and behaves just like BSelect, 
when the BTransfer button is currently configured to behave as 
BAdjust. 
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Required O O O §: 


On athree-button mouse, button 2 is typically used for the BTransfer 
(or BSelect) function. However, in a Common Desktop Environment 
environment, the user may change an environment setting indicating 
that mouse button 2 should be used for the BAdjust function instead. 
BAdjust can be used to toggle the selection state of elements under 
the multiple selection model. 


In a collection that uses multiple selection, clicking BSelect or 
BAdjust on an unselected element adds that element to the current 
selection. Clicking BSelect or BAdjust on a selected element removes 
that element from the current selection. Clicking BSelect or BAdjust 
moves the location cursor to that element. 


Mouse-Based Range Selection 


4-5: This item has been replaced by items k: and I:. 


Required O O O K: 


y n/a n 
Required O O O F: 


In a collection that uses range selection, pressing BSelect on an 
unselected element sets an anchor on the element, or at the position 
where BSelect was pressed, and deselects all elements in the 
collection. If BSelect is released before the drag threshold has been 
exceeded, then the element under the pointer should be selected. If 
BSelect Motion exceeds the drag threshold, then a new selection 
should begin. The anchor and the current position of the pointer 
determine the current range. As BSelect is dragged through the 
collection, the current range is highlighted. When BSelect is released, 
the anchor does not move, and all the elements within the current 
range are selected. 


Range selection allows the user to select multiple contiguous elements 
of a collection by pressing and dragging BSelect. 


In a collection that uses range selection, pressing BSelect on an 
currently selected element should not cause all other elements in the 
selection set to be deselected. If BSelect is released before the drag 
threshold is exceeded, then, at that point, all other elements should 
be deselected and the element under the pointer should remain 
selected. If BSelect Motion exceeds the drag threshold, then no 
element should be deselected and a drag operation should begin. 
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Required O 0 O #6: 


Required O O O 47: 


4-8: 
y n/faon 


Required O O O ™: 


Required O O O NM: 


In a text-like collection that uses range selection, the anchor point is 
the text pointer position when BSelect is pressed, and the current 
range consists of all elements between the anchor point and the 
current text pointer position. 


In text-like collections, elements are ordered linearly, and a text 
pointer is always considered to be between elements at a point near 
the actual pointer position. 


In a graphics-like or list-like collection that uses a marquee to 
indicate the range of a range selection, the current range consists of 
those elements that fall completely within the marquee. If there is an 
anchor element, the marquee is always made large enough to enclose 
it completely. Otherwise, an anchor point is used and is the point at 
which BSelect was pressed; the anchor point determines one corner of 
the marquee. If the collection is not arranged as a list or matrix, the 
marquee is extended to the pointer position. If the collection is 
arranged as a list or matrix, the marquee is either extended to 
completely enclose the element under the pointer or extended to the 
pointer position. Clicking BSelect on a selectable element makes it an 
anchor element, selects it, and deselects all other elements. 


A marquee, or highlighted rectangle, is often used to indicate the 
range of a selection in graphics-like and list-like collections. 


This item has been deleted. 


If your application contains collections that follow the range selection 
model, BAdjust is supported and behaves just like Shift+B Select, 
when the BTransfer button is currently configured to behave as 
BAdjust. 


On a three-button mouse, button 2 is typically used for the BTransfer 
function. However, in a Common Desktop Environment environment, 
the user may change an environment setting indicating that mouse 
button 2 should be used for the BAdjust function instead. BAdjust can 
be used to extend the selection set in the same manner as 

Shift+B Select. 


In a collection that uses range selection, when the user presses 
Shift+BSelect, or BAdjust, the anchor remains unchanged, and an 
extended range for the selection is determined, based on one of the 
extension models. 
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The extended range is determined by the anchor 
and the current pointer position, in exactly the 
same manner as when the selection was initially 
made. 


The selection can only be enlarged. The extended 
range is determined by the anchor and the current 
pointer position, but then is enlarged to include 
the current selection. 


A balance point is defined at the midpoint of the 
current selection. When the user presses 
Shift+BSelect or BAdjust on the opposite side of 
the balance point from the anchor, this model 
works exactly like the reselect model. When the 
user presses Shift+B Select, BAdjust, or starts a 
navigation action modified by Shift on the same 
side of the balance point as the anchor, this model 
moves the anchor to the opposite end of the 
selection and then works exactly like the resel ect 
model. 


When the user releases BSelect or BAdjust, the anchor does not move, 
all the elements within the extended range are selected, and all the 
elements outside of it are deselected. 


Mouse-Based Disc ontiguous Selection 


Optional O O O Reselect 

Optional O O O Enlarge Only 

Optional O O O Balance Beam 
y nan 


Required O O O 49: Ina collection that uses discontiguous selection, the behavior of 
BSelect is exactly the same as in the range selection model. After the 
user sets the anchor with BSelect, Shift+BSelect works exactly as in 
the range selection model. 


Discontiguous selection is an extension of range selection that allows 
the user to select multiple discontiguous ranges of elements. 


Required O O O 410:In a collection that uses discontiguous selection, when the current 
selection is not empty and the user clicks Control+B Select, the anchor 
and location cursor move to that point. If the current selection is not 
empty and the user clicks Control+B Select on an element, the 
selection state of that element is toggled, and that element becomes 
the anchor element. 
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Required O O O #11: 


Required O O O 412: 


y n/aon 
Required O O O OG 


In discontiguous selection, Control +B Select Click provides a 
convenient means of moving the anchor and toggling the selection 
state of the element under the pointer. 


In a collection that uses discontiguous selection, Control +BSelect 
Motion toggles the selection state of a range of elements. The range 
itself is determined exactly as for BSelect Motion. Releasing 
Control+B Select toggles the selection state of the elements in the 
range according to one of two models: 


Anchor Toggle Toggling is based on an anchor element. If the 
range is anchored by a point, and is not empty, the 
anchor element is set to the element within the 
range that is nearest to the anchor point. Toggling 
sets the selection state of all elements in the range 
to the inverse of the initial state of the anchor 
element. 


Full Toggle The selection state of each element in the extended 
range is toggled. 


In discontiguous selection, Control +BSelect provides a convenient 
means of toggling the selection state of elements in a range. 


In a collection that uses discontiguous selection, after 
Control +B Select toggles a selection, Shift+B Select or 

Control +Shift+8 Select extends the range of toggled elements. The 
extended range is determined in exactly the same way as when Shift 
BSelect is used to extend a range selection. When the user releases 
Control +Shift+8 Select, the selection state of elements added to the 
range is determined by the toggle model in use (either Anchor Toggle 
or Full Toggle). If elements are removed from the range, they either 
revert to their state prior to the last use of Control+B Select or change 
to the state opposite that of the elements remaining within the 
extended range. 


Shift+B Select and Control +Shift+B Select provide a convenient means 
of extending the range of toggled elements. 


In a collection that uses discontiguous selection, BAdjust can be used 
to extend the range of a discontiguous selection. The extended range 
is determined in exactly the same way as when BAdjust is used to 
extend a range selection. 
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176 


On a three-button mouse, mouse button 2 is typically used for the 
BTransfer function. However, in a Common Desktop Environment 
environment, the user may change an environment setting indicating 
that mouse button 2 should be used for the BAdjust function instead. 
BAdjust can be used to extend the selection set in the same manner 
as Shift+B Select. 


Keyboard Selection 


Required O O O 413: 


y n/aon 
Required O O O 414: 


The selection models support keyboard selection modes according to 
the following rules: 


* Single selection supports only add mode. 
* Browse selection supports only normal mode. 
* Multiple selection supports only add mode. 


© Range selection supports normal mode. If it also supports add 
mode, normal mode is the default. 


* Discontiguous selection supports both normal mode and add mode. 
Normal mode is the default. 


Selection must be available from the keyboard. In normal mode, used 
for making simple contiguous selections from the keyboard, the 
location cursor is never disjoint from the current selection. In add 
mode, used for making more complex and possibly disjoint selections, 
the location cursor can move independently of the current selection. 


If a collection supports both normal mode and add mode, Shift+F 8 
switches from one mode to the other. Mouse-based selection does not 
change when the keyboard selection mode changes. In editable 
components, add mode is a temporary mode that is exited when the 
user performs an operation on the selection or deselects the selection. 


Shift+F 8 provides a convenient means of switching between normal 
mode and add mode. 
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Keyboard-Based Single Selection 


Required O O O 4415:1In a collection that uses single selection, the navigation keys move 
the location cursor independently from the selected element. If the 
user presses the Select key or the Spacebar on an unselected element, 
the element with the location cursor is selected, and any other 
selection in the collection is deselected. 


Single selection supports only add mode. Pressing the Select key or 
the Spacebar is similar to clicking BSelect. 


Keyboard-Based Browse Selection 


Required O O O 416:!n a collection that uses browse selection, the navigation keys move 
the location cursor and select the cursored element, deselecting any 
other element. If the application has deselected all elements or if the 
cursor is left disjoint from the selection, the Select key or the 
Spacebar selects the cursored element and deselects any other 
element. 


Browse selection supports only normal mode. A navigation operation 
is similar to dragging BSelect. 


ee Keyboard-Based Multiple Selection 


Required O O O 4417:In a collection that uses multiple selection, the navigation keys move 
the location cursor independently from the current selection. The 
Select key or the Spacebar on an unselected element adds the element 
to the current selection. Pressing the Select key or the Spacebar on a 
selected element removes the element from the current selection. 


Multiple selection supports only add mode. Pressing the Select key or 
the Spacebar is similar to clicking BSelect. 


Keyboard-Based Range Selection 


Required O O O 418:In a collection that uses range selection and is in normal mode, the 
navigation keys move the location cursor and deselect the current 
selection. If the cursor is on an element, it is selected. The anchor 
moves with the location cursor. 
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178 


Required O O O 419: 


Required O O O 420: 


y n/aon 
Required O O O 421: 


Text-like collections can use a different model in which the navigation 
keys leave the anchor at its current location, except that, if the 
current selection is not empty, it is deselected and the anchor is 
moved to the location of the cursor prior to navigation. 


Range selection supports normal mode, and, if the collection also 
supports add mode, normal mode is the default. 


In a collection that uses range selection, whether in normal mode or 
add mode, the Select key or Spacebar (except in a text component) 
moves the anchor to the cursor, deselects the current selection, and, if 
the cursor is on an element, selects the element. Unless the anchor is 
on a deselected item, Shift+Select or Shift+Spacebar (except in text) 
extends the selection from the anchor to the cursor, based on the 
extension model used by Shift+BSelect (Reselect, Enlarge Only, or 
Balance Beam. 


In range selection, pressing the Select key or Spacebar is similar to 
clicking BSelect, and pressing Shift+Select or Shift+Spacebar extends 
the range as with Shift+BSelect. 


In a collection that uses range selection and is in normal mode, using 
Shift in conjunction with the navigation keys extends the selection, 
based on the extension model used by Shift+B8 Select. If the current 
selection is empty, the anchor is first moved to the cursor. The cursor 
is then moved according to the navigation keys, and the selection is 
extended based on the extension model used by Shift+B Select. 


In range selection, shifted navigation extends the selection in a 
similar manner to dragging Shift+B Select. 


In a collection that uses range selection and is in add mode, the 
navigation keys move the location cursor but leave the anchor 
unchanged. Shifted navigation moves the location cursor according to 
the navigation keys, and the selection is extended based on the 
extension model used by Shift+BSelect. 


Shifted navigation in add mode is similar to shifted navigation in 
normal mode, except that when the selection is empty the anchor does 
not move to the cursor prior to navigation. 
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Keyboard-Based Discontiguous Selection 


Required O O O 422: 


Required O O O 423: 


In a collection that uses discontiguous selection and is in normal 
mode, all keyboard operations have the same effect as in the range 
selection model. 


Normal mode does not permit multiple discontiguous selections. 


In a collection that uses discontiguous selection and is in add mode, 
the Select key or Spacebar moves the anchor to the location cursor 
and initiates toggling. If the cursor is on an element, the selection 
state of that element is toggled, but the selection state of all other 
elements remains unchanged. Shift+Select or Shift+Spacebar and 
shifted navigation operations extend the selection between the anchor 
and the location cursor, based on the toggle mechanism used by 
Control +BSelect (Anchor Toggle or Full Toggle). 


Add mode permits use of the keyboard to make multiple 
discontiguous selections. 


Canceling a Selection 


Required O O O 424: 


Your application uses the Cancel key to cancel or undo any incomplete 
motion operation used for selection. Once the user presses the Cancel 
key to cancel a motion operation, the application ignores subsequent 
key and button releases until after all buttons and keys are released. 
Pressing the Cancel key while extending or toggling leaves the 

selection state of all elements as they were prior to the button press. 


The Cancel key allows the user to cancel an incomplete selection 
operation quickly and consistently. 


Autosc rolling and Selection 


y nia 


Required O O O 425: 


If the user drags the pointer out of a scrollable collection during a 
motion-based selection operation, autoscrolling is used to scroll the 
collection in the direction of the pointer. If the user presses the Cancel 
key with BSelect pressed, the selection operation is canceled. 


Autoscrolling provides a convenient means of extending a selection to 
elements outside the viewport of a scrollable collection. 
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Selecting and Deselecting All Hements 


Required O O O 426: 


Required O O O 427: 


In a collection that uses multiple, range, or discontiguous selection, 
Control -+/ selects all the elements in the collection, places the anchor 
at the beginning of the collection, and leaves the location cursor at its 
previous position. 


Control-+/ provides the user with a convenient means of selecting all 
of the objects in a collection. 


In a collection that is in add mode, Control-+\ deselects all the 
elements in the collection. In a collection that is in normal mode, 
Control-+\ deselects all the elements in the collection, except the 
element with the location cursor if the location cursor is being 
displayed. In either mode, Control+\ leaves the location cursor at its 
current position and moves the anchor to the location cursor. 


Control+\ allows the user to deselect all of the selected objects 
quickly and uniformly. 


Using Mnemonics forHements 


y nan 


Required O O O 428: 


If your application supports mnemonics associated with selectable 
elements, typing a mnemonic while the collection has the keyboard 
focus is equivalent to moving the location cursor to the element and 
pressing the Select key or Spacebar. 


Mnemonics within a collection of selectable elements provide an 
additional selection method. 


Selection Actions 


Required O O O 429: 


When the keyboard focus policy is explicit, the destination component 
is the editable component that last had the keyboard focus. When the 
keyboard focus policy is implicit, the destination component is the 
editable component that last received mouse button or keyboard 
input. 


The destination component is used to identify the component on 
which certain operations, primarily data transfer operations, act. 
There is only one destination component at a time. 
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Required O O 


Required O O 


Required O O 


y nia 
Required O O 


Required O O 


Required O O 


4-30: 


4-31: 


4-32: 


4-33: 


4-34: 


4-35: 


If the keyboard focus is in a component (or a pop-up menu of a 
component) that supports selections, operations that act on a 
selection act on the selection in that component. 


A selection operation acts on the component that has focus, if that 
component supports selections. 


If the keyboard focus is in a component (or a pop-up menu of a 
component) that supports some operation that does not act on a 
selection, invoking the operation acts on that component. 


An operation that does not act on a selection acts on the component 
that has focus, if that component supports the operation. 


Inserting or pasting elements into a selection, except for a primary 
transfer operation at the bounds of the primary selection, first deletes 
the selection if pending delete is enabled. 


Pending delete controls the conditions under which the selection is 
deleted. It is enabled by default. 


In normal mode, inserting or pasting elements disjoint from the 
selection also deselects the selection, except for primary transfer 
operations whose source and destination are in the same collection. In 
add mode, the selection is not deselected. 


In add mode, a transfer operation that is disjoint from the selection 
does not affect the selection. 


In editable list-like and graphics-like collections, Delete deletes the 
selected elements. 


Delete provides a consistent means of deleting the selection. 


In editable text-like collections, Delete and Backspace behave as 
follows: 


e |f the selection is not empty and the control is in normal mode, the 
selection is deleted. 


e If the selection is not empty, the control is in add mode, and the 
cursor is not disjoint from the selection, the selection is deleted. 
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182 


Transfer Models 
Required O O O 436: 


y n/aon 
Required O O O 437: 


e |f the selection is not empty and the control is in add mode, but the 
cursor is disjoint from the selection, Delete deletes one character 
forward, and Backspace deletes one character backward. 


e If the selection is empty, Delete deletes one character forward, and 
Backspace deletes one character backward. 


In text, Delete and Backspace provide a convenient way to delete the 
entire selection or single characters. 


If the move, copy, or link operation the user requests is not available, 
the transfer operation fails. 


Three transfer operations are generally available: copy, move, and 
link. The user requests one of these operations by pressing the 
buttons or keys appropriate for the type of transfer. |n general, for 
mouse-based operations, the modifier Control forces a copy, Shift 
forces a move, and Control+Shift forces a link. However, any 
requested transfer operation must fail if that operation is not 
available. 


If a collection does not have a fixed insertion point or keep elements 
ordered in a specific way, the insertion position for transferred data is 
determined as follows: 


* For BTransfer-based (or BSelect) primary and drag transfer 
operations, excepted as noted below for text collections, the 
insertion position is the position at which the user releases 
BTransfer (or BSelect). 


* Ina text-like collection, when the user drops selected text, the 
insertion position is the position at which the user releases 
BTransfer (or Bselect). When the user drops an icon, the insertion 
position is the text cursor and the data is pasted before it. 


* Ina list-like collection, the insertion position for other transfer 
operations is the element with the location cursor, and the data is 
pasted before it. 
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Required O O O DP: 


Required O O O @ 


y n/aon 
Required O O O F: 


The insertion position is the position in the destination where 
transferred data is placed. Some mouse-based transfer operations 
place data at the pointer position if possible. Other operations, 
including keyboard-based transfer, generally place the data at the 
location cursor. 


Your application supports the use of mouse button 1 to perform drag- 
and-drop operations. 


In Motif 1.2, drag and drop is typically performed using button 2 ona 
three-button mouse (BTransfer). However, in the Common Desktop 
Environment environment, mouse button 1 (BSelect) should be 
supported for drag and drop to support mouse usage compatible with 
other graphical user interface (GUI) environments. A drag can be 
initiated with either mouse button 1 or mouse button 2. 


When button 2 of a three-button mouse is configured to operate as 
BAdjust, your application does not perform any BTransfer operations 
when clicking mouse button 2. 


On athree-button mouse, button 2 is typically used for the BTransfer 
(or BSelect) function. However, in a Common Desktop Environment 
environment, the user can change an environment setting indicating 
that mouse button 2 should be used for the BAdjust function instead. 
When this is the case, BAdjust click should not result in the transfer 
of any data. 


BSelect should always initiate a drag if the drag is started on a 
selected item. The drag starts once the drag threshold has been 
reached. This is true for text regions, scrolling lists, and other similar 
elements. 


Clipboard Transfer 


Required O O O 438: Keyboard-based clipboard selection actions are available in every 


editable collection in your application. 


Clipboard selection actions need to be available from the keyboard. 
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Required O O O “39: 


Required O O O 440: 


Required O O O #41: 


Required O O O 442: 


y n/aon 
Required O O O 443: 


Your application uses the Cut key (or Shift+Delete) and the Cut entry 
on the Edit menu to cut the selected elements from an editable 
component to the clipboard. 


The Cut key (or Shift+Delete) and the Cut entry on the Edit menu 
offer a consistent means of cutting the selection to the clipboard from 
the keyboard. 


Your application uses the Copy key (or Control -Hnsert) and the Copy 
entry on the Edit menu to copy the selected elements to the clipboard. 


The Copy key or (Control nsert) and the Copy entry on the Edit 
menu offer a consistent means of copying the selection to the 
clipboard from the keyboard. 


Your application uses the Paste key (or Shift nsert) to paste the 
contents of the clipboard into an editable component. 


The Paste key (or Shift nsert) offers a consistent way of pasting the 
contents of the clipboard from the keyboard. 


If Paste or Paste Link is invoked using a component's pop-up menu, 
the data is pasted at the insertion position of the component. 
However, if the pop-up menu is popped up over a selection, the 
selection is first deleted, even if pending delete is disabled, and the 
pasted data replaces it, if possible. 


Popping up a pop-up menu over a selection indicates that a Paste or 
Paste Link operation should replace the selection. 


If Paste or Paste Link is invoked from the Edit menu or by a 
keyboard operation, and the insertion position in the target 
component is not disjoint from a selection, the pasted data replaces 
the selection contents if pending delete is enabled. 


Pending delete determines whether the selection is deleted when the 
insertion position is not disjoint from the selection and Paste or Paste 
Link is invoked from the Edit menu or by a keyboard operation. 
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Required O O 


Required O O 


Required O O 


Required O O 


y nia 
Required O O 


Primary Transfer 


4-44: 


4-45: 


4-46: 


4-47: 


In an editable collection, BTransfer Click, Control+BTransfer Click, 
Alt, Copy, and Control+Alt+nsert copy the primary selection to the 
insertion position. (Note that the insertion position is usually 
different for mouse and keyboard operations.) 


These operations provide a convenient way for the user to force a copy 
operation. 


In an editable collection, Shift+BTransfer Click, Alt+Cut, and 
Alt+Shift+Delete move the primary selection to the insertion position. 
(Note that the insertion position is usually different for mouse and 
keyboard operations.) 


These operations provide a convenient way for the user to force a 
move operation. 


In an editable collection, Control+Shift+BTransfer Click places a link 
to the primary selection at the insertion position. 


Control +Shift+BTransfer provides a convenient way for the user to 
force a link operation. 


A Primary Move moves the primary selection as well as the elements 
selected; that is, the element moved to the destination becomes 
selected as the primary selection. Primary Copy and Primary Link do 
not select transferred data at the destination. 


This rule provides the expected treatment of the selection in a move, 
copy, and link operation. 


Quick Transfer 


4-48: 


All text components support quick transfer. 


Quick transfer is used to make a temporary selection and then 
immediately move, copy, or link that selection to the insertion 
position of the destination component. In text, quick transfer provides 
a convenient way to move, copy, or link text without disturbing the 
primary selection. 
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Required O O O 449: 


Required O O O 450: 


Required O O O 51: 


Required O O O 452: 


Required O O O 453: 


y n/aon 
Required O O O 454: 


If a component supports quick transfer, Alt+BTransfer Motion or 
Control +Alt+BTransfer Motion temporarily selects elements in the 
specified range and, on release, copies them to the insertion position 
of the destination component. 


These operations provide a convenient way to perform a quick copy. 


If a component supports quick transfer, Alt+Shift+B Transfer Motion 
temporarily selects elements in the specified range and, on release, 
moves them to the insertion position of the destination component. 


This operation provides a convenient way to perform a quick cut. 


If a component supports quick transfer, Control +Alt+Shift+BTransfer 
Motion temporarily selects elements in the specified range and, on 
release, places a link to them at the insertion position of the 
destination component. 


This operation provides a convenient way to perform a quick link. 


Quick transfer does not disturb the primary selection or affect the 
clipboard, except when the destination of the transfer is within or on 
the boundaries of the primary selection and pending delete is enabled. 
In this case, quick transfer deletes the contents of the primary 
selection, leaving an empty primary selection, before pasting the 
transferred elements. 


Quick transfer is a secondary selection mechanism, so it cannot 
disrupt the primary selection. When the destination of the transfer is 
in the primary selection, quick transfer replaces the primary selection 
with the secondary selection. 


With quick transfer, the range of the temporary selection is 
determined by using the same model as when BSelect Motion 
determines the range of a primary selection. 


This rule provides consistency between primary selection and quick 
transfer operations. 


If the user drags the pointer out of a scrollable collection while 
making the temporary selection, autoscrolling is used to scroll the 
collection in the direction of the pointer. If the user releases 
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Required O O 


Required O O 


Required O O 


Required O O 


y nia 
Required O O 


BTransfer with the pointer outside of the collection, or if the user 
presses the Cancel key with BTransfer pressed, the highlighting is 
removed and a transfer is not performed. 


Autoscrolling provides a convenient means of extending a temporary 
selection to elements outside the viewport of a scrollable collection. 


Drag Transfer 


4-55: 


4-56: 


4-57: 


4-58: 


4-59: 


Certification Checklist 


In a collection that supports selection, Shift+B Transfer Release or 
Shift+B Select Release forces a drag move operation. If a move is not 
possible, the operation fails. 


This mechanism offers a convenient way for the user to force a move 
operation. 


In a collection that supports selection, Control+BTransfer Release or 
Shift+BSelect Release forces a drag copy operation. If a copy is not 
possible, the operation fails. 


This mechanism offers a convenient way for the user to force a copy 
operation. 


In a collection that supports selection, Control+Shift+BTransfer 
Release pr Shift+BSelect Release forces a drag link operation. If a 
link is not possible, the operation fails. 


This mechanism offers a convenient way for the user to force a link 
operation. 


When a drag move operation moves a selection within the same 
component, the selection moves along with the elements selected. 


In other words, when selected elements are moved with a drag 
operation, they should stay selected after the move. This mechanism 
offers a convenient way to move the selection within a component. 


In text-like collections, initiating a drag within a selected region 
drags the entire text selection. 
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Required O 


Required O 


Required O 


Required O 


Required O 


Required O 


Required O 


4-60: 


4-61: 


4-62: 


4-63: 


4-64: 


4-65: 


4-66: 


To be consistent, drag-and-drop actions need to operate on the entire 
selection. 


In list-like and graphics-like collections, initiating a drag with either 
BSelect or BTransfer on a selected element drags the entire selection. 


To be consistent, drag-and-drop actions need to operate on the entire 
selection. 


In list-like and graphics-like collections, initiating a drag with 
BTransfer or BSelect on an unselected element drags just that 
element and leaves the selection unaffected. 


Unselected elements can be dragged without affecting the selection. 


When a drag is initiated in an unselected region and the pointer is 
over two possible draggable elements, the drag uses the draggable 
element highest in the stacking order. 


This guideline ensures the consistency of drag operations. 


When your application starts a drag operation, the pointer is replaced 
with a drag icon. 


A drag icon provides visual feedback that a drag operation is in 
progress. 


All drag icons used by your application include a source indicator. 


A source indicator gives a visual representation of the elements being 
dragged. 


Pressing the Cancel key ends a drag-and-drop operation by canceling 
the drag in progress. 


The Cancel key provides a consistent way for the user to cancel a drag 
operation. 


Releasing BTransfer ends a drag-and-drop operation. 


Releasing BTransfer offers a consistent means of ending a drag 
operation. 


CDE: Style Guide and Certification Checklist 


10= 


y nia n 467: 


Required O O O 468: 


Required O O O 469: 


Recommended O O O S: 


When BTransfer (or BSelect) is released, the drop operation 
ordinarily occurs at the location of the hot spot of the drag icon 
pointer and into the highest drop zone in the stacking order. However, 
if a drop occurs within a selection and pending delete is enabled, the 
transferred data replaces the contents of the entire selection. 


This rule provides consistency in the treatment of mouse-based 
transfer operations. 


After a successful transfer, the data is placed in the drop zone, and 
any transfer icon used by your application is removed. 


A transfer icon can be used to represent the type of data being 
transferred during a drop operation. A successful drop operation 
results in the transfer of data. 


After a failed transfer, the data remains at the drag source and is not 
placed in the drop zone. Any transfer icon used by your application is 
removed. 


A failed drop operation does not result in the transfer of data. 


In a collection that supports selection, if BTransfer Motion (or BSelect 
Motion) results in the start of a drag operation, feedback is presented 
to the user that indicates that a copy, move, or link operation is in 
progress. Whether the operation is a copy, move, or link depends on 
the type of object created at the drop zone and whether the source 
object is removed. 


Although, typically, an unmodified drag results in a move operation, 
depending on the location of the source object and the target drop 
zone, the drag may in fact result in a copy or link operation. F or 
example, dragging an icon representing an attachment to a mail 
message typically results in a copy of the attachment being created as 
opposed to the original being removed from the mail message. Any 
feedback presented should incorporate use of a drag icon that 
portrays the source object being manipulated. 
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190 


y nan 
Recommended O O O t: 


Recommended O O O U: 


Recommended O O O V: 


Optional O O O W: 


In a collection that supports selection, if Control +BTransfer Motion or 
Control +BSelect Motion results in the start of a drag operation, 
feedback is presented to the user that indicates that a copy operation 
is in progress. 


The feedback presented should incorporate use of a drag icon that 
portrays the source object being copied. 


In a collection that supports selection, if Control +Shift+B Transfer 
Motion or Control+Shift+B Select Motion results in the start of a drag 
operation, feedback is presented to the user that indicates that a link 
operation is in progress. 


The feedback presented should incorporate use of a drag icon that 
portrays the source object being linked. 


In acollection that supports copy, move, or link operations that can be 
performed by dragging, the feedback presented to the user during the 
drag operation indicates whether a single object or multiple objects 
are being manipulated. 


Feedback provided during the drag operation should ensure that the 
user feels confident that the desired set of objects is being dragged. 
The drag icon used for multiobject drag operations should integrate 
the feedback used to indicate whether the operation is a move, copy, 
or link. 


If your application allows the user to paste data into its data pane, it 
allows the user to drag and drop files from the File Manager into the 
data pane. 


The user should be able to drag and drop files into application data 
panes. The result should be the inclusion of some element of the file, 
or the display of an error message indicating that the file selected 
cannot be incorporated into the application's data. Drag transfers 
that are accepted can result in a number of different responses from 
your application: 1) the icon image for the file might be inserted at 
the drop point; 2) the application might perform some activity using 
the data contained within the file as its input; 3) the data contained 
within the file might be inserted at the drop point; or 4) the name of 
the file might be inserted at the drop point. 
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ComponentAc tivation 
Basic Activation 


y nan 


Required O O O S12: 


Required O O O 52: 


Required O O O 53: 


Required O O O S& 


Required O O O 5S: 


Your application uses BSelect to activate a button. 


BSelect, the first mouse button, provides a consistent means of 
activating a button using the mouse. 


When a button has the focus, your application uses the Select key or 
Spacebar to activate the button. 


The Select key and Spacebar provide a uniform way of selecting a 
button. Selecting a button is equivalent to activating the button. 


When an activatable menu entry has the focus, your application uses 
the Select, Spacebar, Enter, or Return key to activate the entry. 


The Select, Spacebar, Enter, and Return keys offer a consistent means 
of activating a menu entry using the keyboard. 


When BSelect is pressed over a button, the appearance of the button 
changes to indicate that releasing BSelect will activate the button. If, 
while BSelect is pressed, the pointer is moved outside of the button, 
the visual state is restored. If, while BSelect is still pressed, the 
pointer is moved back inside of the button, the visual state is again 
changed to indicate the pending activation. If BSelect is pressed and 
released within a button, the button is activated, regardless of 
whether the pointer has moved out of the button while it was pressed. 


The visual state of a button offers a cue to the user about whether the 
button will be activated when the mouse button is released. 


If a selectable element of a collection is activatable, BSelect Click, the 
Select key, and Spacebar (except in text) select it. BSelect Click 2 
selects and activates it. 


This rule provides for consistent integration of activation and 
selection in a collection where elements can be both selected and 
activated. 


Certification Checklist 191 


10 


192 


Required O O O * 


Accelerators 


y n/aon 
Required O O O 56: 


Required O O O 57: 


Mnemonics 


Required O O O 58: 


The time allowed to detect a double click (*doubleClickTime: 500) 
should be no less than 500 milliseconds. 


If your application uses accelerators, the component with the 
accelerator displays the accelerator key or key combination following 
the label of the component. 


An accelerator is a key or key combination that invokes the action of 
some component regardless of the position of the location cursor when 
the accelerator is pressed. So that the user knows that there is an 
accelerator associated with a component, the accelerator needs to be 
displayed. 


If a button with an accelerator is within a primary or secondary 
window, or within a pull-down menu system from its menu bar, it is 
activatable whenever the input focus is in the window or the menu 
bar system. If a button with an accelerator is within a pop-up menu 
system, it is activatable whenever the focus is in the pop-up menu 
system or the component with the pop-up menu. 


An accelerator must be activatable from the window or component 
associated with the accelerator. 


If your application uses mnemonics, the label for the component with 
the mnemonic contains the character that is its mnemonic. If the 
label does not naturally contain the character, the mnemonic is placed 
in parentheses following the label. 


A mnemonic is a single character that can be associated with any 
component that contains a text label. Mnemonics provide a fast way 
of selecting a component from the keyboard. To let the user know that 
there is a mnemonic associated with a selection, the mnemonic is 
underlined in the label of the selection by the toolkit. F or a mnemonic 
to be underlined, the label for a selection needs to contain the 
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mnemonic character. If the label does not contain the mnemonic, 
putting the mnemonic in parentheses following the label provides 
visual consistency. 


y n/faon 
Required O O O Y: Mnemonic characters must be chosen for ease-of-location within the 
text of a label. Wherever possible, use the first character of the label. 
If that is not possible, try to use the last character of the label, or if 
there is more than one word, the first character of the second word. 
After that, go through the label from the second character on until a 
unique mnemonic is found. 


Required O O O 59: All mnemonics are case insensitive for activation. 


The user must be able to activate a mnemonic by pressing either the 
lowercase or the uppercase variant of the mnemonic key. 


Required O O © 5-10: When the location cursor is within a menu or a menu bar, pressing 
the mnemonic key of a component within that menu or menu bar 
moves the location cursor to the component and activates it. If a 
mnemonic is used for an option button or for a cascading button in a 
menu bar, pressing Alt and the mnemonic anywhere in the window or 
its menus moves the cursor to the component with that mnemonic 
and activates it. 


A mnemonic is generally activatable when the location cursor is 
within the component that contains the mnemonic. Pressing Alt and 
the mnemonic provides a way to activate a visible mnemonic when 
the location cursor is within the window that contains the mnemonic. 


Rar off Activation 


Required O O O 511: Activating a tear-off button tears off the menu that contains the 
button. 


A tear-off button is like a push button with the special interaction of 
tearing off the menu from its cascading button. Tear-off buttons use 
the same basic activation as other buttons. 
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194 


Required O O O S12: 


Help Activation 


y n/aon 
Required O O O 513: 


Required O O O 2 


When a menu with a tear-off button is posted, pressing BTransfer in 
the tear-off button starts a tear-off action. As long as BTransfer is 
held, a representation of the menu follows the movement of the 
pointer. Releasing BTransfer ends the tear-off action by unposting the 
menu system, creating a new window at the current pointer location 
that contains the contents of the menu, and giving focus to the new 
window in explicit pointer mode. 


Your application uses the Help key on a component to invoke any 
context-sensitive help for the component or its nearest ancestor with 
context-sensitive help available. 


The Help key offers the user a consistent mechanism for invoking 
context-sensitive help. 


Your application provides context-sensitive help at all locations. 


The user should never get a “help not available” message. 


Default Activation 


Required O O O 5-14: 


Required O O O 515: 


If your application uses default push buttons in a window, the current 
default push button is highlighted. When the focus is on a push 
button, its action is the default action, and the push button shows 
default highlighting. If the default action in a window varies, some 
push button always has default highlighting, except when there is no 
current default action. 


Placing emphasis on the default push button in a dialog box provides 
the user with a visual cue about the expected reply to the dialog box. 


When focus is in a window with a default action and an activatable 
menu does not have the focus, the Enter key and Control+Return 
invoke the default action. If focus is in a component other than 
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y n/aon 
Required O O O 516: 


multiline text or an activated menu, Return also invokes the default 
action. These actions have no other effect on the component with the 
focus, unless the default action has some effect on that component. 


These rules ensure that the means of invoking a default action are 
consistent across applications. 


Except in the middle of a button motion operation, pressing the 
Cancel key anywhere in a dialog box is equivalent to activating the 
Cancel push button in the dialog box. 


The Cancel key provides a uniform means of canceling dialog box 
from the keyboard. 


ExpertActivation 


Required O O O 517: 


Required O O O 518: 


Required O O O 519: 


If your application supports expert activation, expert actions exist 
only as shortcuts to application features that are available through 
another mechanism. 


Expert activation, using mouse double-clicking on buttons, provides a 
convenient way for experienced users to perform certain tasks 
quickly. However, new users and keyboard-only users need to be able 
to perform the same tasks. 


When the focus is on a button used for expert activation, no default 
action is available, unless the default and expert actions are the 
same. 


This rule minimizes possible confusion between default and expert 
activation. 


If a component with an expert action is selectable, activating the 
expert action first selects the component and then performs the 
expert action. 
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A user needs to be able to select a component, even if it has an expert 
action associated with it. 


Previewing and Autorepeat 


Required O O O 5-20:If your application supports activation preview using BSelect, the 
previewing information is removed when the user releases BSelect. 


Activation preview presents the user with additional information that 
describes the effect of activating a button. This information cannot 
interfere with the normal operation of the application. 


Cancel Activation 


y nan 


Required O O O 5-21: Pressing the Cancel key stops current interaction in the following 
contexts: 


During a mouse-based selection or drag operation, it cancels the 
operation. 


During a mouse-based scrolling operation, it cancels the scrolling 
action and returns the system to its state prior to the start of the 
scrolling operation. 


Anywhere in a dialog box that has a Cancel push button, it is 
equivalent to activating that push button, except during a mouse- 
based selection or drag operation. 


In a pull-down menu, it either dismisses the menu and moves the 
location cursor to the cascading button used to pull it down, or 
unposts the entire menu system. In a pop-up menu, option menu, 
tear-off menu, or menu bar, it unposts the menu system. 


When the focus is in a torn off menu window, it closes the torn off 
menu window. 


These guidelines for the Cancel key ensure the consistent operation of 
the key across applications. 
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Window Management 


Window Support 


This section corresponds to section 7.2 of the OSF/ Motif Style Guide 
Revision 1.2. The different window types are discussed throughout the 
OSF/ Motif Style Guide Revision 1.2 and this book. In particular, see 
Chapter 6, “Application Design Principles.” 


Required O O © aa: Application windows should be clearly distinguishable as primary or 
secondary windows based on appearance and behavior. 


Primary Window: 


¢ Primary window decoration (see “Window Decorations” on 
page 197) 


¢ Primary window management (see “Window Management Actions” 
on page 201) 


© Window stacking, workspace placement, and minimization can be 
independent of other primary windows 


Secondary Window: 


® Secondary window decoration (see “Window Decorations” on 
page 197) 


® Secondary window management (see “Window Management 
Actions” on page 201) 


© Window stacking, workspace placement, and minimization tied to 
the associated primary window 


Window Decorations 


y n/faon 
Required O O © ab: Windows that support particular window management functionality 
must request the corresponding window decoration (for example, a 
window that can be minimized should request the minimize button). 


Required O O © ac: Windows that support any window management functionality (move, 
resize, minimize, maximize, close, and others) must have a window 
menu with items for that functionality. 
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Required O O O ad: Follow Common Desktop Environment window decoration 
conventions, as shown in Table 10-1. 


Table 10-1Common Desktop Environment Window Decoration Conventions 


Borde 
r Title Menu Min Max Resize 
Primary Window: 
Default Yes Yes Yes Yes Yes! Yes! 
Front Panel Yes? No Yes? Yes No No 
Secondary Window: 
Default Yes Yes Yes No No? No? 
Front Panel No Yes Yes No No No 


Decorations for resizeand maximize should be provided for primary windows if appropriate. 
2TheF ront Panel has custom visuals for the window decorations. 


3S econdary windows should bedesigned such that resizing and maximization arenot necessary or 
appropriate. I f a secondary window must be resizable and maxi mizable, the associated decorations should 
bedisplayed. 


y n/faon 
Required O O © ae: Follow Common Desktop Environment window menu conventions. 
Items should appear in the window menu if they are applicable to the 
window or its minimized window icon. 


¢ Restore (R) 

© Move (M) 

© Size (S) 

© Minimize (n) 

@ Maximize (x) 

© Lower (L) 

® Occupy Workspace ... (OQ) 

* Occupy All Workspaces (A) 
® Unoccupy Workspace (U) 
© Close (C) Alt+F4 
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Optional O O O af: 


Optional O O O ag: 


Applications should not add items to the window menu. If an 
extraordinary requirement has an application add items to the 
window menu, the items should be appended to the end of the menu 
with a separator between Close and the application items. 


Accelerators, aside from Alt+F 4 for Close, should not be used in the 
window menu (to minimize conflict with other uses of the Alt key for 
application accelerators, localization, and others). 


Window Navigation 


This section corresponds to section 7. 4 of OSF/ Motif Style Guide Revision 
1.2. There are no checklist items for application developers. 


Icons 


Optional O O O ah: 


y n/aon 
Optional O O O Al: 


Optional O O O A: 


Applications should provide unique window icons for their primary 
windows. The window icon image should have a similar appearance to 
the associated file or Front Panel icon image. 


The window icon label should contain the same text as the title of the 
corresponding primary window, or an abbreviated form of it. Refer to 
“Layout” on page 202 for window title guidelines. 


The window icon image should have a similar appearance to the 
associated file or Front Panel icon image. Refer to “Design Philosophy 
and Helpful Hints” on page 50. 


Application Window Management 


Window Placement 


Recommended O O © ak: Applications should not require or force windows or window icons to 


be positioned at a particular screen location. 
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Recommended O O 


Optional O O 


Recommended O O 


Recommended O O 


y nia 
Optional O O 


am: 


ao: 


A secondary window is placed by the application relative to the 
associated primary window. It should be placed close to, but not 
obscuring, the component that caused it to be displayed and the 
information that is necessary to interact with the dialog box. 


Some suggestions are given in section 6.2.4.3, “Determining Dialog 
Box Location and Size,” of the OSF/ Motif Style Guide, Revision 1.2. 
Additional or modified recommendations include: 


If a dialog box does not relate to specific items in the underlying 
window, it should be placed below the menu bar (if there is one) and 
centered (horizontally) over the work area. 


If a secondary window is allowed to be stacked below its associated 
primary window (not constrained to stay on top of the primary 
window), it should be placed such that it is not completely covered by 
the primary window. This recommendation takes precedence over 
other placement recommendations. 


If a menu or dialog box is already on display, reinvoking the command 
that caused it to be displayed automatically brings that window or 
menu to the front of the window stack without changing its position 
on the screen. 


Window (Doc ument) Clustering 


ap: 


Windows that are closely related in supporting a particular task 
should be placed in a window cluster. Secondary windows are 
automatically placed in a window cluster with the associated primary 
window. Windows in a window cluster are stacked together, 
minimized or normalized together, and kept in the same workspace. 


Note - Currently the only mechanism for forming a window cluster that is 
supported by the Window Manager is to indicate a primary-secondary 
relationship. 
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Required O O O 


Required O O O 


Required O O O 


Recommended O O O 


y nan 
Required O O O 


Recommended O O O 


Recommended O O O 


Window ManagementActions 


aq: Windows should follow Common Desktop Environment window 
management functionality conventions, as shown in Table 10-2. 


Table 10-2Common Desktop Environment Window Management Conventions 


Close Move Lower Min Max Resize 
Primary Window: 
Default Yes Yes Yes Yes Yes! Yes! 
Front Panel No Yes Yes Yes No No 
Secondary Window: 
Default Yes Yes Yes No No? No? 
Subpanel Yes Yes Yes No No No 


1R esize and maximize functionality should be provided for primary windows if appropriate. 
2S econdary windows can contain the Maximum and Resize window manager functions, if appropriate. 


ar: Windows that support particular window management functionality 
should request corresponding window decoration (for example, a 
window that can be minimized should request the minimize button). 


as: Windows that have form factor constraints need to set Window 
Manager hints for minimum size, maximum size, aspect ratio, and 
resize increment as appropriate. 


at: Maximizing a window should show more content (objects or controls) 
if appropriate (as opposed to scaling up the sizes of objects and 
controls). 


au: Windows that have Close or Exit functionality need to support the 
window management protocol for Close if there is a window menu. In 
the case of dialog boxes, the Close item on the window menu 
corresponds to the Cancel functionality or dialog box dismissal with 
no further action taken. 


av: When your application creates a new window, it should come up in 
the user’s current workspace and only occupy that single workspace. 


aw: Application windows that are related to a particular task should move 
together between workspaces. 
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Session Management Support 


Required O O O @X: 


Required O O O ay: 


Optional O O O AZ: 


Optional O O O ba: 


Optional O O O bb: 


Optional O O O be: 


Applications should support I nterclient Communications Conventions 
Manual (I1CCCM) mechanisms for session management of their 
primary windows and key properties. 


Applications should support |CCCM mechanisms for session 
management of all associated windows (that is, secondary windows 
that may include help windows). 


Applications should accept messages from the Common Desktop 
Environment Session Manager that inform them the user is logging 
out and should save their state at that time. 


Applications that have a single primary window that is open at the 
time the user logs out should restore the primary window, in the 
workspace last occupied, when the user logs in again. 


Save user context wherever possible. For example, applications that 
support the editing of files should save the state of the file at logout 
and should restore the file in the application window when users log 
in again. 


Applications that have multiple primary windows that are open at the 
time the user logs out should restore all primary windows, in their 
respective workspaces, when the user logs in again. 


Application Design Principles 


Layout 


Main Window 


y nia 


Required O O O G1: 


Your application should be composed of at least one main window. 


A main window contains a client area and, optionally, a menu bar, a 
command area, a message area, and scroll bars. The client area 
contains the framework of the application. The use of a main window 
ensures interapplication consistency. 
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Required O O © bd: 


Required O O © be: 


Required O O O 62: 


y n/aon 
Required O O O 6&3: 


The default size of the application's main window must be large 
enough to accommodate a typical amount of data, but should not fill 
the entire physical display size to minimize visual conflicts with other 
applications. 


Each application potentially must share the display with other 
applications. The default window size should not take up all the 
available screen space. 


Resize corners should be included in any main window that 
incorporates a scrolling data pane or list. 


Resize corners should be included in any main window that 
incorporates a scrolling data pane or list. Any changes to the overall 
size of the window should result in a corresponding increase or 
decrease in the size of the scrollable portion. Additionally, your 
application might reorganize elements within the window based on 
the increased or decreased amount of space (for example, it might 
reorganize a row of buttons into two rows). 


If your application has multiple main windows that serve the same 
primary function, each window closes and iconifies separately. 


For example, a text editor might allow the user to edit multiple 
documents, each in its own main window. Each window is then 
treated as a separate application and can be closed or iconified when 
it is not being used. 


If your application has multiple main windows that serve different 
primary functions, each window should be able to iconify 
independently of the other windows. 


For example, a debugger might provide separate main windows for 
editing source code, examining data values, and viewing results. Each 
window can be iconified when it is not being used, but it is up to the 
application to decide whether each window closes separately or 
whether closing one window closes the entire application. 


Certification Checklist 203 


10 


204 


Window Titles 


Optional O O © Df: 


Optional O O O bg: 


Optional O O O bh: 


Optional O O O Di: 


Optional O O O bj: 


y n/a in 
Recommended O O O Dk: 


The title of your primary window (the main window your application 
displays to the user) should be the name of your application. 


Note that this does not have to be the actual name of the executable 
invoked by the user. 


Carefully consider how the title you choose for your primary window 
works when it is used in icons and pop-up windows. If the name of the 
pop-up window is too long, you may remove the application title; 
however, without the title, users might have difficulty telling which 
pop-up window belongs with the originating primary window. 


Use initial capital letters for each word in the title (in languages that 
support capitalization). 


Follow the application name for each property window, as a 
minimum, with the title Properties and the name of the object it 
affects. 


Begin the title of each pop-up window with the application title 
followed by a colon, then the title of the pop-up window. The colon 
should have a space both before and after it for readibility. 


Pop-up windows should always indicate which primary window they 
are associated with (which primary window invoked that pop-up). 


Use a hyphen to denote the current file name, when the application 
has files that can be loaded or saved. The hyphen should have a space 
before and after it. Only the base name of the file should be displayed, 
not the entire path. 


The hyphen is used to denote specific instances of a window or data. 
The colon serves to delimit general categories or commands. F or 
example, a file manager might have the following title for a 
Properties dialog box: 


File Manager : Properties - myfile 


Follow the application name for each command window with the same 
title that is on the window button or window item users choose to 
display that window. 
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Optional O O O 


bl: 


In the case of multiple primary windows, include the application 
name at the beginning of each window title, and add a name that 
uniquely identifies that primary window. No separator should be 
provided for these names (for example, Calendar Manager 
Multibrowse, Catalog Search, Admintool Databases). 


Optional O O O bm: An abbreviated name for the application may be used on other 


Required O O O 


Required O O O 


y n/aon 
Recommended O O O 


windows, so long as it is done on all windows. 


Menu Bar 


Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You must make the appropriate 
changes for other locales. 


6-4: 


6-5: 


6-6: 


If your application has a menu bar, it is a horizontal bar at the top 
edge of the application, just below the title area of the window frame. 
A menu bar organizes the most common features of an application. It 
contains a list of menu topics in cascading buttons; each button is 
associated with a distinct pull-down menu containing commands that 
are grouped by common functionality. The use of a menu bar yields 
consistency across applications. 


The menu bar for your application contains only cascading buttons. 


When other buttons are included as topics in a menu bar, they inhibit 
menu browsing. 


This item has been deleted. It is replaced by the following guideline. 


There are several common menu operations that should be considered 
“standard”. The standard menu bar entries are File, Edit, View, 
Options and Help. If your application provides that functionality to 
the user, it should be included in the menu bar under the appropriate 
name.The contents of these menu entries are discussed below in more 
detail. 
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Recommended O O O bo: 


Standard menu bar entries should be presented in the following 
order: 


File Edit View Options Help 


You should exclude from your menu bar any item shown in the 
preceding text if your application does not support the associated 
function. For example, if your application does not support the ability 
to display its data in different views, then you should not include a 
View menu. 


You may add application-specific menus in between any of the 
standard menu items, with the following exceptions: 


- The File menu, if present, is located in the first menu position on 
the left. 


- The Help menu is located on the far right position. 

- If File and Edit are present, they should be next to each other. 
For example, your application may have: 

File Edit <category1> <category2> View Options <category3> Help 


Applications that are not file-oriented in nature (or that manage files 
transparently, not exposing this activity to the user) should replace 
the File menu with one or more application-specific menus. 


Replacing the File menu: 
Replacement1: <app-label> Selected 
Replacement2: <app-label ><obj-type> 
Replacement3: <obj-type> 


You may use Replacement! if your application has more than one 
object type. Items on <app-label> would be used for global actions 
that are not specific to an object type. The items in Selected are 
actions that pertain to objects that are currently selected, and may 
change depending on what objects are selected. If nothing is selected, 
this menu should have a single item that says (none selected). If an 
item is selected, but there are no items that apply to that object, this 
menu should have a single item that says (none). 
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y n/a in 
Recommended O O O bp: 


You may use Replacement2 if your application has a single object 
type. Actions that are global to the application are on <app-label>, 
and actions that are specific to the object type are on <obj-type>. 


You may use Replacement3 if your application has a single object 
type, and does not require an <app-label>menu. For example, a Print 
Manager might contain a Printer menu. 


All other menubar guidelines that apply to File-oriented applications 
also apply to non-File-oriented applications. Thus, the following 
menubar would be valid: 


<app-label > Selected Edit <categoryl> View <category2> Help 


Applications that are complex or are extremely domain-specific (for 
example, an application for medical imaging and diagnosis of cat scan 
data) may require other approaches to their menu bar design. For 
example, 


<app-l abel ><category1><category2> Selected Edit <object-type> 
Options Help 


Exit or Close should be located on the first (leftmost) menu of your 
menubar. 
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File Menu Contents 


Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You must make the appropriate 
changes for other locales. 


y n/aon 
Required O O O ba: 


Required O O O 6&7: 


Required O O O 


Required O O O 


Required O O O 


If the user chooses Exit, or in any other manner indicates that the 
application should be terminated, but there are changes to the 
current file that have not been saved, your application displays a 
dialog box asking whether the changes should be saved before exiting. 


The user must always be given the opportunity to explicitly state 
whether unsaved changes should be saved or discarded. A dialog box 
similar to the one described should also be displayed if the user 
chooses the Open from the File menu, but has not saved changes to 
the current file. 


If your application uses a File menu, it contains the following choices, 
with the specified functionality, when the actions are actually 
supported by your application. 


New Creates a new file. If the current client area will be 
used to display the new file, your application clears 
the existing data from the client area. If changes made 
to the current file will be lost, your application 
displays a dialog box, asking the user about saving 
changes. The mnemonic is N. 


Open... Opens an existing file by prompting the user for a file 
name with a dialog box. If changes made to the 
current file will be lost, your application displays a 
dialog box asking the user about saving changes. The 
mnemonic is O. 


Save Saves the currently opened file without removing the 
existing contents of the client area. If the file has no 
name, your application displays a dialog box, 
prompting the user to enter a file name. The 
mnemonic is S. 
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Required O O O Save As... 
y n/a in 
Recommended O O O Print 
Recommended O O O Close 
Required O O O Exit 


Saves the currently opened file under a new name by 

prompting the user for a file name with a dialog box. If 
the user tries to save the file using an existing name, 
your application displays a dialog box that warns the 
user about a possible loss of data. Does not remove the 
existing contents of the client area. The mnemonic is 

A. 


Schedules a file for printing. If your application needs 
specific information to print, it displays a dialog box, 
requesting the information from the user. In this case, 
the menu entry is followed by an ellipsis (Print...). The 
mnemonic is P. 


Closes the current primary window and its associated 
secondary windows. If your application uses only a 
single primary window or multiple dependent primary 
windows, this action is not supplied. The mnemonic is 
C. 


Ends the current application and all windows 
associated with it. If changes made to the current file 
will be lost, your application displays a dialog box, 
asking the user about saving changes. The mnemonic 
is X. 


The use of a File menu with these common file operations yields 
consistency across applications. 


<Object-type>/ Selected Menu Contents 


Recommended O O © br: _ If your application uses an <object-type> menu or a Selected menu, it 
contains the following choices, with the specified functionality, when 
the actions are actually supported by your application. Items should 
be presented to the user in the order listed below. 


The <object-type> menu contains controls that allow the user to 
create instances of the object-type. Both the <object-type> and 
Selected menus allow the user to manipulate object instances. 
Additional items should be added to the <object-type> or Selected 
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menus if they relate solely to the manipulation of objects managed by 
the application (as opposed to more generic services that the 
application might provide). 

Recommended O O O New... Creates a new instance of the object-type. If 
appropriate, a dialog box is presented allowing the 
user to specify the values for settings associated with 
that object. 

y n/faon 

Optional O O O Move To... Allows the user to move the selected objects into a 
folder. A file selection dialog box is displayed allowing 
the user to select the desired folder. 

Optional O O O Copy To... Allows the user to copy the selected objects into a 
folder. A file selection dialog box is displayed allowing 
the user to select the desired folder. 

Optional O O O Put in Workspace 
Allows the user to put a link for the object onto the 
Common Desktop Environment desktop in the current 
workspace. 

Any of the preceding three menu choices should be provided only if 
the objects managed by your application are able to reside as separate 
entities outside of your application's main window. For example, a 
printer object created by a printer management application might be 
able to be placed in a Folder window and function as an application 
unto itself. Your application should also support drag and drop as a 
method for performing any of these actions. 

Optional O O O Delete Removes the selected objects. A confirmation dialog 
box should be presented to the user before the object is 
actually deleted. 

Recommended O O O Properties Displays a Properties window that shows the current 
values for settings associated with the selected object. 
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Recommended O O 


y nia 
Required O O 


Optional O O 


Optional O O 


Optional O O 


Optional O O 


Optional O O 


Optional O O 


O 


=) 


<Default Action> 


Edit Menu Contents 


This choice should enact the default action for the 
selected object. “Open” is a typical default. 


Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You must make the appropriate 
changes for other locales. 


6-8: = If your application uses an Edit menu, it contains the following 
choices, with the specified functionality, when the actions are actually 
supported by your application: 


Undo 


Cut 


Copy 


Copy Link 


Paste 


Paste Link 
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Reverses the most recently executed action. The 
mnemonic is U. 


Removes the selected portion of data from the 
client area and puts it on the clipboard. The 
mnemonic is T. 


Copies the selected portion of data from the client 
area and puts it on the clipboard. The mnemonic is 
C. 


Copies a link of the selected portion of data from 
the client area and puts it on the dipboard. The 
mnemonic is K. 


Pastes the contents of the clipboard into the client 
area. The mnemonic is P. 


Pastes a link of the data represented by the 
contents of the clipboard into the client area. The 
mnemonic is L. 
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Optional O O 


Optional O O 


Optional O O 


Optional O O 


Optional O O 


y nia 
Optional O O 


Optional O O 


Recommended O O 


=} 


Delete 


Select All 


Deselect All 


Select Pasted 


Reselect 


Promote 


Removes a selected portion of data from the client 
area without copying it to the clipboard and does 
not compress the remaining data. The mnemonic is 
E.; 


Removes a selected portion of data from the client 
area without copying it to the clipboard. The 
mnemonic is D. 


Sets the primary selection to be all the elements in 
a component of the client area. 


Removes from the primary selection all the 
elements in a component of the client area. 


Sets the primary selection to the last element or 
elements pasted into a component of the client 
area. 


Sets the primary selection to the last selected element 
or elements in a component of the client area. This 
action is available only in components that do not 
support persistent selections and only when the 
current selection is empty. 


Promotes to the primary selection the current 
selection of a component of the client area. This action 
is available only for components that support 
persistent selections. 


The use of an Edit menu with these common editing operations yields 
consistency across applications. 


bs: If your application does not provide an <object-type> or Selected 
menu, but allows the user to select data within the window and 
manage settings for the selected data, then it provides a Properties ... 
choice as the last item in the Edit menu. 
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Required O O O 6&9: This item has been deleted. 


View Menu 


Recommended O O © bt: If your application provides a View menu, it only contains functions 
that affect the way the current data is presented. It does not contain 
any option that alters the data itself. 


Options Menu 


Recommended O O © bu: If your application has global settings that control the way the 
application behaves, it provides an Options menu from which these 
can be set. 
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y 
Recommended O O 


Required 


Optional 


Recommended 


Recommended 


Recommended 


Optional 


Optional 


Optional 
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O 


O 


O 


O 


>] 


Help Menu Contents 


Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You must make the appropriate 
changes for other locales. 


bv: 


If your application includes a Help menu, it contains the following set 
of choices, with the specified functionality, when the actions are 
actually supported by your application. The Help choices included 
here supercede those listed for Motif 1.2. 


Overview 


Index 


Provides general information about the window from 
which help was accessed or about the application 
overall. The mnemonic is V. Place a separator after. 


Provides an index listing topics for all help 
information available for your application. The 
mnemonic is |. 


Table of Contents 


Tasks 


Reference 


Tutorial 


Keyboard 


Mouse 


Provides a table of contents listing topics for all help 
information available for your application. The 
mnemonic is C. 


Provides access to help information indicating how to 
perform different tasks using your application. The 
mnemonic is T. 


Provides access to reference information. The 
mnemonic is R. 


Provides access to your application's tutorial. The 
mnemonic is L. 


Provides information about your application's use of 
function keys, mnemonics, and keyboard accelerators. 
Also provides information on general Common 
Desktop Environment use of such keys. The mnemonic 
isK. 


Provides information about using a mouse with your 
application. The mnemonic is M. 
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y nan 


Optional O O O 


Recommended O O O 


Required O O O 


Required O O O 


Mouse and Keyboard 


On Item 


Using Help 


Provides information about your application's use of 
function keys, mnemonics, keyboard accelerators, and 
using a mouse with your application. Also provides 
information on general Common Desktop Environment 
use of such keys. The mnemonic is M. Use rather than 
separate mouse and keyboard choices if this 
information is best presented together. 


Initiates context-sensitive help by changing the shape 
of the pointer to the question mark pointer. When the 
user moves the pointer to a component and presses 
BSelect, any available context-sensitive help for the 
component is presented. The mnemonic is O. Set off 
with separators on both sides. 


Provides information on how to use the Common 
Desktop Environment Help Viewer. The mnemonic is 
U. Set off with separators on both sides. 


About applicationname 


Displays a dialog box indicating, minimally, the name 
and version of your application, and displays its icon 
or some other signature graphic for your application. 
The mnemonic is A. 


6-10: This item has been deleted. It is replaced by item bv:. 


Attachment Menu Contents 


Recommended O O © bw: If your application uses an attachment menu, it contains the 
following choices, with the specified functionality, when the actions 
are actually supported by your application. 


Recommended O O O 


Add File... 


Certification Checklist 


Selects files and other items to be attached. A file 
selection box is displayed allowing the user to select 
the desired files to attach. The default button in the 
file selection box is Attach. 
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y n/aon 
Recommended O O O 


Recommended O O O 


Recommended O O O 


Recommended O O O 


Recommended O O O 


216 


Save As... 


Rename... 


Delete 


Select All 


Pop-up Menus 


Saves the currently selected attachments. The user is 
prompted with a file selection dialog box for indicating 
where in the file system the attachments are to be 
saved. When multiple attachments are selected, the 
name field is inactive and the current names of the 
attachments are used as the name of the new file. This 
menu item is active only when one or more 
attachments are selected. 


Renames the attachment icon. The application should 
provide in-line renaming of attachment icons, such as 
File Manager uses. If the application cannot provide 
in-line renaming, then Rename allows the user to 
rename an attachment by displaying a dialog box, 
requesting the name from the user. This menu item is 
active only when a single attachment is selected. It is 
not active when multiple attachments are selected. 


Deletes attachments from the attachment list. This 
menu item is active only when an attachment is 
selected. 


Selects all the attachments in the attachment list. 


Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You must make the appropriate 
changes for other locales. 


bx: If your application provides functions that apply to a data pane and 
not any specific element therein, then a pop-up menu is provided that 
contains the frequently used data pane functions and is accessible by 
pressing BMenu when the mouse pointer is over the background of 
the pane or a nonselectable element within the pane. 
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Recommended O O O by: 


y 


n/a 


n 


Recommended O O O bz: 


Recommended O 


Recommended O 


Optional O 


Optional O 


Optional O 


Optional O 


oO Oo 


0 cb: 


Oo &11: 


Your application should provide a pop-up menu for any element that 
is selectable within its data pane. 


Pop-up menus provide access to frequently used functions and should 
be used pervasively throughout the Common Desktop Environment 
desktop environment. A pop-up menu may contain a collection of 
options that appear in different menus available from the menu bar. 
For example, it may contain items from both the File and Edit menus. 


When a pop-up menu is displayed over an unselected object, any 
action selected from the pop-up menu applies to that object only, and 
not to any other objects that might currently be selected. 


The preceding helps to protect the user from inadvertently applying 
an action to objects that the user may not realize are currently 
selected. Pressing the menu button invokes a pop-up menu pertinent 
to the object under the mouse cursor whether it is selected to not; if 
the object under the mouse cursor and other objects are selected, the 
pop-up menu is pertinent to the selected set. 


Every pop-up menu in your application has a title that indicates the 
function the menu performs or the element on which it operates. 


The functions accessible from within your application's pop-up menus 
are also accessible from buttons displayed within the window or 
menus accessed through the menu bar. 


Because pop-up menus are hidden, they should only provide 
redundant access to functions available from more visible controls 
within the application's windows. 


If your application uses any of the common pop-up menu actions, the 
actions function according to the following specifications. See item cc: 
for supplemental guidelines. 


Properties Displays a Properties dialog box that the user can 
use to set the properties of the component. 


Undo Reverses the most recently executed action. 


Primary Move Moves the contents of the primary selection to the 
component. This action is available only in 
editable components. 
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Optional O O 


y nia 
Optional O O 


Optional O O 


Optional O O 


Optional O O 


Optional O O 


Optional O O 


Optional O O 


Optional O O 


Optional O O 


=) 


Primary Copy 


Primary Link 


Cut 


Copy 


Copy Link 


Paste 


Paste Link 


Clear 


Delete 


Select All 


Copies the contents of the primary selection to the 
component. This action is available only in 
editable components. 


Places a link to the primary selection in the 
component. This action is available only in 
editable components. 


Cuts elements to the clipboard. If the menu is 
popped up in a selection, cuts the entire selection 
to the clipboard. 


Copies elements to the clipboard. If the menu is 
popped up in a selection, this action copies the 
entire selection to the clipboard. 


Copies a link of elements to the clipboard. If the 
menu is popped up in a selection, copies a link to 
the entire selection to the clipboard. 


Pastes the contents of the clipboard to the 
component. This action is available only in 
editable components. 


Pastes a link of the contents of the clipboard to the 
component. This action is available only in 
editable components. 


Removes a selected portion of data from the client 
area without copying it to the clipboard. If the 
menu is popped up in a selection, deletes the 
selection. 


Removes a selected portion of data from the client 
area without copying it to the clipboard. If the 
menu iS popped up in a selection, deletes the 
selection. 


Sets the primary selection to be all of the elements 
in the collection with the pop-up menu. 
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Optional O O O Deselect All Deselects the current selection in the collection 
with the pop-up menu. 

Optional O O O Select Pasted Sets the primary selection to be the last element or 
elements pasted into the collection with the pop-up 
menu. 

y n/faon 
Optional O O O Reselect Sets the primary selection to be the last selected 


element or elements in the component with the 
pop-up menu. This action is available only in 
components that do not support persistent 
selections and only when the current selection is 
empty. 


Optional O O O Promote Promotes the current selection to the primary 
selection. It is available only in components that 
support persistent selections. 


The use of pop-up menus with these common actions yields 
consistency across applications. 


Recommended O O © cc: Pop-up menus for selectable objects contain the following set of 
choices, with the specified functionality, when the actions are actually 
supported by your application. These guidelines supplement item 6- 


11:. 

Optional O O O Move To... Allows the user to move the selected objects into a 
folder. A file selection dialog box is displayed allowing 
the user to select the desired folder. 

Optional O O O Copy To... Allows the user to copy the selected objects into a 
folder. A file selection dialog box is displayed allowing 
the user to select the desired folder. 

Optional O O O Put in Workspace 


Allows the user to put a link for the selected objects 
onto the Common Desktop Environment desktop in 
the current workspace. 
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Optional O O O 
Recommended O O O 


Recommended O O O 


y nan 
Optional O O O Cd: 


Required O O O &12: 


Delete Deletes the selected object. A confirmation is displayed 
to the user before actually removing the object. 


Properties ... Displays a dialog box indicating the current settings 
for attributes associated with the selected object. 


Help ... Displays a help window pertaining to objects of the 
type selected. 


Choices within your pop-up menus are organized in the following 
manner: 


<choices that manage the object such as Open, Save, or Properties> 
wanenen nnn separator ---------------- 

<standard edit menu choices such as Cut, Copy, and Paste> 

wanennn nnn separator ---------------- 

<other choices> 


When a pop-up menu is popped up in the context of a selection, any 
action that acts on elements acts on the entire selection. 


In the context of a selection, pop-up menu actions affect the entire 
selection. 


Dialog Boxes 


Required O O O &13: 


Information dialog boxes do not interrupt the user’s interaction with 
your application. 


An information dialog box conveys information to the user that does 
not require immediate attention, so it does not need to be modal. 
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Menu Design 


Recommended O O O Ce: 


Recommended O O O Cf: 


y n/aon 
Optional O O O CY: 


Recommended O O O ch: 


Optional O O O CI: 


If the selection of a menu item will result in the user being queried 
for more information, such as through the posting of a file selection 
dialog, the menu item should be followed by an ellipsis (“...”). This 
requirement does not apply to menu items that will result in a simple 
warning or confirmation dialog being displayed. 


The use of an ellipsis helps set the user’s expectation for the behavior 
of the interface. When they select an item without an ellipsis, they 
know that they can expect an immediate result. 


Menus accessed from within your application contain at least two 
menu items. 


No menu should contain only one item. If your application provides a 
menu with only one item, you should look at moving that item into 
another menu or making it a button within the window. The longer 
the menu, the more effort is needed for the user to access choices near 
the bottom. If your menu has a lot of choices, break it up into two or 
more menus, or group some items into submenus. 


Submenus accessed from within your application contain at least 
three menu items. 


Submenus may be used to group like items into a single secondary 
cascading menu where putting the items into the primary cascading 
menu would make it too long. However, if your submenu contains only 
two options, you should strongly look at removing the secondary 
cascading menu and putting the options into the primary cascading 
menu since it takes more effort for the user to access options located 
in a submenu. 


No menu in your application contains more than 15 choices. 


The longer the menu the more effort is needed for the user to access 
choices near the bottom. If your menu has a lot of choices, you should 
look at breaking it up into two or more menus, or grouping some 
items into submenus. 


If your application contains a menu that is expected to be accessed 
frequently, then a tear-off menu option is provided in that menu. 
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Optional O O O Gi 


Recommended O O O 


y nan 


Required O O O 


Recommended O O O 


Required O O O 


Recommended O O O 


ck: 


cl: 


cm: 


cn: 


co: 


The user should be able to tear-off frequently accessed menus so that 
these can remain posted on the desktop as the user uses your 
application. 


Provide keyboard accelerators where appropriate. 


If specific menu items within a menu are expected to be used 
frequently, not the menu as a whole, then your application provides 
keyboard accelerators for these items and displays the keyboard 
accelerators in the associated menu to the right of the item to which 
they relate. 


The labels used for items in the menu bar do not appear as options 
within the menus themselves. 


The names of items in the menu bar serve as titles for the options the 
menu contains. The name of the menu bar item should provide a term 
that accurately describes the concept of the category relating all of 
the menu items and should not be used as the name of any item 
within the menu itself. 


Any menu choice that is not currently an appropriate selection is 
dimmed (insensitive). 


Dimmed controls cannot be activated by the user and should appear 
only when the inactive state is short-term (that is, there is something 
the user can do within the application or the desktop environment to 
make the control become active). When the control is persistently 
inactive (because of the current configuration of the application or 
system, or a particular set of companion software is not currently 
installed), the control should be removed rather than dimmed. 


If a menu item is used to indicate a selection state, use a checkbox or 
radio button to indicate the state of the item. Use a checkbox if a 
single item is used to represent on or off states, and use radio buttons 
for multiple adjacent menu items in which only one of the items may 
be selected. 


If radio buttons are used in a menu, use separators between each set 
of radio buttons and other menu items. 


If a checkbox or radio button is used on a menu item, it should always 
be shown as either selected or not selected, and should not dissappear 
when in the unselected state. 
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Required O O O 


Required O O O 


y n/aon 
Recommended O O O 


Required O O O 


Recommended O O O 


6-14: |f your application uses a tear-off button in a menu, the tear-off 
button is the first element in the menu. 


When a tear-off button is activated, the menu changes into a dialog 
box. The tear-off button needs to be the first item in the menu so that 
the entire contents of the menu are torn off. 


6-15: All menus are wide enough to accommodate their widest elements. 


The ability to see the full label of each menu element allows the user 
to browse through a menu. 


Dialog Box Design 


Note - These requirements apply only in a left-to-right language 
environment in an English-language locale. You must make the appropriate 
changes for other locales. 


cp: The title of dialog boxes used within your application adheres to the 
conventions listed in Table 10-3. 


Table 10-3Dialog Box Title Conventions 


Window Usage Window Title Format 

Message <app or object name>: <action or situation> 
Progress <app or object name>: <action>in Progress 
Action (Command) <app name>: <action> 

Object Properties <app name>: <object-type> Properties 


Application Options <app name>: <type> Options 


cq: Every dialog box in your application has at least one button that 
either performs the dialog box action and dismisses it or dismisses 
the dialog box without taking any action. 


6-16: This item has been replaced by item cr:. 


cr: If your application uses common dialog box actions, the actions have 
the following specified functionality and labels: 
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Optional O O 


Optional O O 


Optional O O 


Optional O O 


y nia 
Optional O O 


=) 


Optional O O O 


Optional O O O 


oe) 


Optional O 


oe) 


Optional O 


Optional O O 


Yes Indicates an affirmative response to a question posed 
in the dialog box. 


No Indicates a negative response to a question posed in 
the dialog box. 


OK Applies any changes made to components in the dialog 
box and dismisses the dialog box. 


<command> Applies any changes made to components in the dialog 
box, performs the action associated with the 
<command>, and dismisses the dialog box. 


Should be used in lieu of OK, Yes, or No as a button 
label when it provides more meaning to the user as to 
the action that will be performed when that button is 
clicked. 


Apply Applies any changes made to components in the dialog 
box and does not dismiss it. 


Retry Causes the task in progress to be attempted again. 


Stop Ends the task in progress at the next possible break 
point. 


Pause Causes the task in progress to pause. 


Resume Causes a task that has paused to resume. 


Save As Defaults 
Saves the current settings as the default settings that 
will appear the next time the window is displayed. The 
settings are not applied to any selected object and the 
dialog box is not dismissed. 


A Save As Defaults button should be provided if it is 
expected that a user would want to use different 
default values for a set of controls within a dialog box 
than those that you provide as the factory settings. 
For example, a Save As Defaults button might be 
provided in a “New <object-type>” window, allowing 
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Optional O O O 


y nian 
Optional O O O 


Optional O O O 


Recommended O O O 


Recommended O O O CS: 


Optional O O O Ct: 


the user to indicate that whenever a new instance of 
that object-type is created, the current values should 
be displayed as the default settings instead of the 
values given by the application. 


Reset Cancels any changes that have not yet been applied by 
your application. The controls within the dialog box 
are reset to their state since the last time the dialog 
box action was applied. | f no changes have been 
applied within the current invocation of the dialog box, 
the controls are reset to the state when the dialog box 
was first displayed. 


Reset to Factory 
Cancels any changes that have not yet been applied. 
Components in the dialog box are reset to their default 
state and value as specified by the vendor that 
delivered the application (that is, the controls are 
restored to the original factory settings). 


Cancel Dismisses the dialog box without performing any 
actions not yet applied. 


Help Provides help for the dialog box. 


Any visible control that is not currently active or whose setting is 
currently invalid is dimmed. 


Dimmed controls cannot be activated by the user and should appear 
only when the inactive state is short-term (that is, there is something 
the user can do within the application or the desktop environment to 
make the control become active). When the control is persistently 
inactive (because of the current configuration of the application or 
system, or a particular set of companion software is not currently 
installed), the control should be removed rather than dimmed. 


Keep the size of your dialog boxes to a minimum. Remember that on 
low-resolution displays, dialogs may take up most of the screen real 
estate, and may even run off the edge of the screen if not designed 
correctly. 
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Optional O O 


Optional O O 


Optional O O 


y nia 
Optional O O 


cu: 


Cv: 


Cw: 


CX: 


Avoid complexity in your dialog boxes. If your dialog box must support 
many functions, consider using an expandable dialog box (see 
“Expandable Windows” on page 240), or use more than one dialogina 
nested fashion. 


Avoid the use of resize handles in your dialog box. However, you may 
use resize handles when resizing is useful in allowing users to see 
more information; for example, when your dialog contains a scrolling 
list that is likely to be quite long, and users will frequently need to 
search the list. 


Every dialog box in your application has exactly one default button 
that is activated when the Return key is pressed. 


The default button should be associated with the most likely response 
from the user and should not be potentially destructive or 
irreversible. Some applications may have dialog boxes that do not 
reveal a default button until a specific set of fields has been filled out 
or otherwise manipulated. 


If a dialog box displayed by your application has controls that are 
considered to be advanced features, use an expandable dialog box, or 
use a multiple page dialog box that provides a <category> option 
menu that allows a user to navigate to each page. 


Controls that relate to advanced features should not be displayed 
with the set of options initially displayed to the user. The typical user 
should be presented with only those options that are necessary to use 
the basic functionality of the application. Users looking to access 
advanced functionality within the dialog box may use the <Category> 
option button (see Figure 7-1). If the number of advanced controls is 
few, or the settings for these controls are highly related to the 
settings of basic controls displayed in the dialog box (that is, the 
settings of the advanced controls change when the user changes 
settings for basic controls), you might choose to provide an 
expandable dialog box (see the section on Expandable Windows and 
Dialog Boxes). 
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Required O O 


Recommended O O 


Recommended O O 


y nia 
Required O O 


Optional O O 


Required O O 


Optional O O 


Property Windows 


cy: 


CZ: 


da: 


If your application provides settings that control the behavior of the 
application, these settings are displayed in an application properties 
window that is accessible from an Options menu. 


If your application manages objects and allows the user to see or 
modify settings for these objects, these settings are displayed in an 
object properties window that is accessible from a Properties ... choice 
in the Edit, <object-type>, or Selected menus, as well as from the pop- 
up menu associated with the object. 


If your application provides access to a Properties or Options window, 
this window includes the following set of buttons in the order listed, 
with the specified functionality, when supported by your application. 


OK Applies any changes made to components in the dialog 
box and dismisses it. OK may be replaced by a more 
appropriate label; for example, Add. The alternate 
label should be a verb phrase. 


Apply Applies any changes made to components in the dialog 
box and does not dismiss it. 


Reset Cancels any changes that have not yet been applied by 
your application. The controls within the dialog box 
are reset to their state since the last time the dialog 
box action was applied. | f no changes have been 
applied within the current invocation of the dialog box, 
the controls are reset to the state when the dialog box 
was first displayed. 


Reset to Factory 
Cancels any changes that have not yet been applied. 
Components in the dialog box are reset to their default 
state or value as specified by the vendor that delivered 
the application (that is, the controls are restored tothe 
original factory settings). 
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Required O O O 


Required O O O 
Recommended O O O db: 


Cancel Dismisses the dialog box without performing any 
actions not yet applied. 


Help Provides help for the dialog box. 


If your application provides a Properties window that displays 
settings for a selected object, the Properties window tracks the 
current selection and modifies the state of any controls to accurately 
reflect the properties of the currently selected object. 


File Selection Dialog Box 


Optional O O O de: 


y n/a in 
Recommended O O O dd: 


Recommended O O O de: 


If your application allows the user to open or save files, then it uses 
the standard Common Desktop Environment file selection dialog box 
to allow the user to select specific files and directories. 


All user interactions with the file system should be facilitated by 
providing a point-and-click style of choosing files and directories. The 
user should never be forced to memorize and type in file paths. The 
user must be able to explore the contents and structure of the file 
system using scrolling lists. The expert user, however, should be able 
to directly enter a complete file path, as well as be able to use relative 
paths and environment variables such as SHOME. 


The labels and contents of the standard file selection dialog box may 
be modified as appropriate to make clear the particular context in 
which it is being used within your application. 


If your application allows the objects it manages to exist as separate 
entities within folders or toolboxes within the desktop environment, a 
Copy To menu option or button is provided that displays a file 
selection dialog box that allows the user to select the desired folder in 
which an icon for the object should be placed. 


The file selection dialog box should not display hidden (dot) 
directories or files, unless your users depend on using these types of 
files. If your application does support displaying hidden files, you 
should supply a check box allowing users to toggle between showing 
and not showing hidden files, or else allow users to toggle between 
showing and hiding files at a global level in your application. 
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Recommended O O O Af: 


Required O O O dg: 


y nia 


Optional O O O dh: 


Required O O O 


Recommended O O O 


Optional O O O 


The file selection dialog box should not show the full path names for 
files and directories, but should only show the relative names, except 
for the directory text field 


The global Common Desktop Environment setting should be: 


XmFileSelectionBox.fullPathMode: false 


Unless your application overrides this behavior, your file selection 
dialog box should not show full path names in the list boxes. 


In general, the file selection dialog box should recall the directory 
location that was previously set by the user. 


For example, if the user brings up Save As and navigates to 
/users/jay/letters to save the file, the next time the user brings 
up Save As, the file selection box should be in the directory 
/users/jay/letters. This information, however, should not be 
recalled once the user has closed the primary window, but should 
resort to the default directory. 


About Dialog Box 


di: 


The About dialog box should contain a minimum set of information 
about the application that is visible in a single text pane. 


That minimum set should be: 
©® Application name 

© Version number 

© Release date 

® Copyright 


The About dialog box should contain a Close button. Other buttons 
are optional, such as Help and More. 


Other information contained in the about box might be: 


dj: 


dk: 


Information about the operating system or other aspects required to 
run the application, for example, Common Desktop Environment 1.0. 


A More Information dialog box for additional information such as 
development team credits, licensing, client or xhost information. 
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Dialog Box Layout 


Optional O O O di: 


Controls within your dialog box are placed in a left-right, top-down 
layout based on the order in which the user is expected to fill out or 
choose options within the dialog box. 


Note - This assumes that your application is being designed for a left-to- 
right language environment. Alternative design approaches may be 
necessary for other locales. 


y nan 


Required O O O dm: 


Required O O © dn: 


Optional O O O do: 


Push buttons that affect the dialog box as a whole, either by 
modifying its contents or layout, invoking the action of the dialog box, 
or dismissing the dialog box, are located at the bottom of the dialog 
box. 


In general, there should only be one row of buttons at the bottom of a 
dialog box. If your application has dialog boxes that contain several 
global buttons, it may be necessary to create two or more rows of 
buttons at the bottom of the dialog box. The last row should contain 
the standard dialog box buttons (OK, Reset, Cancel, and Help). If a 
dialog box contains buttons that are not related to the dialog box as a 
whole, but relate to a specific control within the dialog box, the 
buttons should be located with the control to which they relate. 


If your application provides an Apply button within a dialog box, it 
also provides an OK button or command button that performs the 
dialog box action then dismisses it. 


Your application does not use cascading buttons within dialog boxes 
unless there is absolutely no other design alternative that can be used 
without a negative impact on the layout of your dialog box. 


In general, cascading buttons should only be used within menus and 
menu bars. You should avoid their use in all other locations unless 
absolutely necessary. 
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Recommended O O O GP: 


If your application needs to use cascading buttons outside of a menu 
pane, you should use the DtMenuButton widget. 


Designing Drag and Drop 


Recommended O O O dq: 


Recommended O O O dr: 


y nan 


Recommended O O O ds: 


Required O O © dt: 


Recommended O O O du: 


You should provide a drag-and-drop (DND) method for all objects 
represented as icons. Provide a DND method for all elements that the 
user can directly manipulate. 


Any basic function that your application supports through drag and 
drop is alSo supported through menus, buttons, or dialog boxes. 


Drag and drop is considered an accelerator to functionality that is 
accessible through other user interface controls supported within your 
application. There should be no basic operation that is supported 
solely through drag and drop. 


Use an icon graphic in a dialog box or window to indicate that objects 
within the dialog box or window can be dragged. Use the same icon 
graphic used to represent the draggable object in File Manager. Place 
the icon adjacent to any display of the contents of the object, if such 
display exists. If there is no such display, place the icon in the upper 
right corner of the dialog box or window, unless a more suitable 
placement is determined. The icon should be 32x32 in size and havea 
label under it. The label should indicate what kind of object the icon 
graphic represents. The icon graphic should also be used as the source 
indicator in the drag icon. 


During a drag operation, your application changes the current pointer 
to a drag icon. 


A drag icon provides visual feedback that a drag operation is in 
progress. 


During a drag operation, your application changes the current drag 
cursor to include a source indicator. 


A source indicator gives a visual representation of the elements being 
dragged. 
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Recommended O O O AV: 


Recommended O O O dw: 


During a drag operation, your application changes the current drag 
cursor to indicate invalid drop zones. It uses the standard Common 
Desktop Environment cannot pointer. 


The user must receive feedback as to where an object can and cannot 
be dropped. Minimally, feedback should be provided as to what are 
invalid drop zones. Preferably, feedback for valid drop zones is 
enhanced by use of animation, recessing of the target drop zone, and 
other such drag-over effects. 


During a drag operation, your application changes the drop zone 
feedback to indicate a valid drop zone. 


Preferably, feedback for valid drop zones is enhanced by use of 
animation, recessing of the target drop zone, and other such drag-over 
effects. 
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Required O O O dy: 


Optional O O O dz: 


Recommended O O O €@: 


Required O O O eb: 


Required O O O &: 


Pressing Cancel ends a drag-and-drop operation by canceling the drag 
in progress. 


Cancel provides a consistent way for the user to cancel a drag 
operation. 


Releasing BTransfer (or BSelect) when not over a drop target ends a 
drag-and-drop operation. 


Releasing BTransfer (or BSelect) offers a consistent means of ending 
a drag operation. 


Any cursor change or drag-over effect your application uses occurs 
within .2 seconds of the mouse pointer reaching the target area and 
does not interfere, in any noticeable way, with the interactive 
performance of the drag operation. 


In acollection that supports copy, move, or link operations that can be 
performed by dragging, the feedback presented to the user during the 
drag operation indicates whether a single object or multiple objects 
are being manipulated. 


Feedback provided during the drag operation should ensure that the 
user feels confident that the desired set of objects is being dragged. 
The drag icon used for multi-object drag operations should integrate 
the feedback used to indicate whether the operation is a move, copy, 
or link. 


After a successful transfer, the data is placed in the drop zone, and 
any transfer icon used by your application is removed. 


A transfer icon can be used to represent the type of data being 
transferred during a drop operation. A successful drop operation 
results in the transfer of data. 


If your application removes data upon the completion of a drag and 
drop, it does so only if the drag-and-drop transfer has completed 
successfully. 


If a drag-and-drop operation has been canceled or failed, the data or 
object that was the source of the drag must not be removed. 
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Required O O O ed: 


Recommended O O O €G: 


Recommended O O O €f: 


Recommended O O O &9Y: 


Required O O O &17: 


After a failed transfer, the data remains at the drag source and is not 
placed in the drop zone. Any transfer icon used by your application is 
removed. 


A failed drop operation does not result in the transfer of data. 


If the user drops an object at an inappropriate drop zone within your 
application’s window, your application participates in the display of a 
snap back effect and also posts an error dialog box indicating the 
reason the drop was disallowed. 


The error message should state the context (for example, running 
action A on object B), what happened (for example, could not connect 
to system X), and how to correct the problem (for example, press the 
Help button to obtain information on diagnosing remote execution 
problems). 


Applications that accept only single items should reject all multiple 
item drops. 


There is no consistent method to determine which of the selected 
items the user really wants to drop. 


If your application supports drag and drop as a means of loading a file 
into the application, the application responds to this operation in a 
manner similar to when the file is loaded through more conventional 
means such as choosing Open from the File menu. 


As an accelerator, drag-and-drop loading of files should provide the 
same kind of feedback and behavior as choosing Open from the File 
menu. For example, if changes to a currently loaded file have not yet 
been saved, your application should display a message dialog box 
asking whether the changes should first be saved before loading the 
new file. 


If your application provides any drag-and-drop help dialog boxes, they 
contain a Cancel button for canceling the drag-and-drop operation in 
progress. 
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Recommended O O O 


Recommended O O O 


Recommended O O O 


Recommended O O O 


Recommended O O O 


Installation 


Required O O O 


Interaction 


eh: 


el: 


ej: 


ek: 


el: 


em: 


The Cancel button in the help dialog box provides a convenient way 
for the user to cancel a drag-and-drop operation. 


Drag and drop should not be the only method for attaching objects. 


Double-clicking is a shortcut for selecting the attachment and 
choosing the Open menu item for attachments and should never be 
the only way to access attachments. 


When the user attempts to drop something into the attachment list 
that is not attachable, then the drop fails and the item is snapped 
back to its source. 


When the user has one or more attachments open for editing and 
attempts to do any operation that would result in potentially losing 
the user’s edits, the user should be clearly warned and given the 
opportunity to save changes. 


When the user chooses something to attach from the file selection 
dialog box that is not an attachable item, then the user receives an 
error message explaining why the chosen item cannot be attached. 
For example: 


The folder “My.Stuff” cannot be attached because it is a folder. 
Only documents, applications, and scripts can be attached. 


Applications should be installed to folders in the Application Manager 
not directly to the Front Panel or subpanels. For consistency, only 
Common Desktop Environment desktop components will install to 
these locations. Users may choose to rearrange their Front Panel, but 
applications should not do this without user consent. 


Required O O © 6-18:A warning dialog box allows the user to cancel the destructive action 


about which the dialog box is providing a warning. 
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Recommended O O 


Required O O 


Optional O O 


Optional O O 


O 


en: 


The user needs to have a way to cancel an operation that can cause 
destructive results. 


When your application displays a dialog box, it places the input focus 
at the first text field into which the user is allowed to type an entry, 
or at the first control within the dialog box with which the user 
should interact. 


Input focus should always be placed at a predictable and intuitive 
location. The user should not be forced to set focus at the control most 
likely to be used when the window is displayed. 


As the user presses the Tab key within dialog boxes of your 
application, the input focus moves to different controls within the 
window in a left-right, top-down order. 


Note - This assumes that your application is being designed for a left-to- 
right language environment. Alternative design approaches may be 
necessary for other locales. 


ep: 


er: 


There is always exactly one control within any window of your 
application that has the input focus if the window in which it resides 
has the input focus. 


If any window within your application has focus, some control within 
that window must have focus. The user should not have to explicitly 
set focus to a control within the window. 


When a text field within your application does not have the input 
focus, the text cursor is not displayed within that field. 


Although use of inactive text cursors is allowed within the Motif style, 
it is better to hide the text cursor on focus out rather than display the 
inactive text cursor. This makes it easier for the user to quickly scan 
the screen or a window and determine which text field currently has 
focus. 


Your application provides keyboard mnemonics for all buttons, 
menus, and menu items displayed within the application. 
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Required O O O et: 


Required O O O eu: 


Required O O O €&V: 


Once the user becomes adept at using your application, keyboard 
mnemonics provide the user a quick way to access functionality. 
Mnemonics also facilitate access to functionality from within 
keyboard-centric applications or windows. The user need not 
frequently switch between use of the mouse or use of the keyboard. 
Mnemonics should be provided pervasively throughout the user 
interface. 


Your application provides keyboard accelerators for those functions 
that are expected to be used frequently by the user. 


Keyboard accelerators provide the user who has become expert at 
using your application a quick way to access application functionality 
without having to go through menus and dialog boxes. 


Dialog boxes displayed by your application never block input to other 
applications within the desktop (that is, they are not system modal) 
unless it is absolutely essential that the user perform no other action 
in the desktop until the user responds to the dialog box. 


Applications must allow the user the freedom to access information 
and tools within the user's desktop environment. Only in the most 
dire circumstances should an application ever block access to other 
applications and services within the environment. 


Dialog boxes displayed by your application never block access to other 
functionality within the application (application modal) unless it is 
essential that the state of the application remains unchanged until 
the user responds to the dialog box. 


If your application does not use the values of global environment 
settings, such as multiclick timeout intervals, drag thresholds, 
window color settings, mouse left- or right-handedness, and so on, but 
instead uses its own values for these settings, then your application 
provides one or more Options dialog boxes that allow the user to 
change the values for these settings. 


In general, you should not override the value of settings treated as 
global environment settings. These settings are controlled by the user 
through the Common Desktop Environment Style Manager. If you 
choose to ignore these settings and specify your own settings, then 
your application will behave inconsistently with other applications in 
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Visuals 


y nan 


Recommended O O O CW: 


Recommended O O O 


Recommended O O O 


Recommended O O O 


Recommended O O O 


ex: 


ey: 


ez: 


fa: 


the Common Desktop Environment desktop. If you nevertheless 
choose to provide your own values, then you must provide the user a 
way to make your settings consistent with the rest of the desktop. 


Any icons or graphics displayed by your application are designed to be 
distinguishable on low- (640x480), medium- (800x600), and high- 
(mega-pixel) resolution displays. Alternatively, your application 
provides different sized visuals for low-, medium-, and high-resolution 
displays. 


Desktop system configurations are including more high-resolution 
monitors. The user must be able to discern any visuals used by your 
application on these type of monitors. The embedded base, however, 
still contains many standard VGA monitors. Your application's 
visuals must display well on these systems and should not appear 
overly large. 


Any icons or graphics displayed by your application are designed to 
display well on black-and-white and gray-scale monitors. These 
visuals also display well on low-color (16) systems. 


Icons should be used to represent only objects and applications. 


Icons provide a visual representation for objects and facilitate direct 
manipulation. If icons are used for other purposes (for example, as 
illustrations) where the user can’t drag them, select them, and so on, 
it creates a confusing inconsistency. 


Icons should use only the palette of 22 colors. 


The Common Desktop Environment icon palette was chosen to 
maximize attractiveness and readability without using an 
unnecessary number of colors. Use of additional colors may cause 
undesirable color shifting on the display. 


Icons should be designed for international use. 


Don't use text, symbols, humor, animals, and other items that may be 
interpreted differently in other cultures. 
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y nia 
Required O O 


Required O O 


Required O O 


Oo 


Recommended O 


Required O O 


Recommended O O 


Recommended O O 


Recommended O O 


Recommended O O 


=) 


fc: 


fd: 


fe: 


fg: 


16x16 and 32x32 icons are left-aligned; any empty bits are on the 
right side of the bounding box. 


48x48 icons are centered in the bounding box. 


If you use a tool bar, it should be used only in windows with a menu 
bar. 


Tool bars should contain only operations that are already available to 
the user in your application menus. All items in a tool bar should be 
redundant. 


When an action represented by a tool bar icon is unavailable to the 
user, that icon should be made insensitive, with the associated 
stippled appearance. Whenever a menu item is made insensitive, the 
corresponding tool bar item must be made insensitive as well. 


Give users the option to hide the tool bar. 


The tool bar container is placed directly under the menu bar and 
should be the same width as the window, as well as similar height to 
the menu bar. 


If you use a tool bar in your application, then you should provide a 
status line in the same primary window as the tool bar. 


This status line should provide immediate feedback to the user as to 
the purpose of the button that the mouse is currently over or that has 
the keyboard focus. When the arrow is over a tool bar icon, the status 
line should display a brief definition of what the icon represents or 
what will happen when the user clicks the icon. 


You may provide labels under tool bar icons. These labels should 
serve to explain the purpose of the icon. 


Drawn buttons in the tool bar should be the same width and height. 
Similar or related items should be grouped, and groups should be 
evenly spaced across the tool bar. 


All pixmaps in the tool bar should be the same size. 
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This ensures that all the tool bar buttons are the same size. 


The recommended size of the pixmap is 24x24. The default for the 
drawn button is to resize itself according to the size of its label type, 
which, in this case, would be a pixmap. 


Expandable Windows 


y n/a in 
Recommended O O O fn: 


Recommended O O O fo: 


Required O O O fp: 


Recommended O O O fa: 


Recommended O O O fr: 


fo) 
fo) 
ri 


Recommended O 


Required O O O ft: 


The primary pane of the dialog box or window should contain all of 
the controls needed to complete the task. This should include all 
critical and frequently used functionality. 


It is assumed that infrequently used features are placed in the 
secondary pane. The core functionality of the application should not 
depend on any controls placed in secondary panes. 


Command buttons are aligned along the bottom of the dialog box. 
When the window is expanded to show a secondary pane, then 
buttons are moved to the bottom of the secondary pane. See 
Chapter 6, “Application Design Principles” for information about 
layout of action buttons in dialog boxes. 


If important controls must be placed in the secondary pane, the 
application can specify that the window in question should be 
displayed in its expanded state by default. Users should still be able 
to shrink the window by pressing the Contract button. 


The secondary pane should expand in the direction most consistent 
with users’ expectations, the reading pattern of the language in which 
it will be displayed, and the content of the information displayed. 


If possible, the panes should have the same default width. 


A separator should be used to separate the primary pane from the 
secondary pane. 


The user needs to have clear visual feedback as to which elements are 
in the primary and which in the secondary panes of the expandable 
window. 
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Required O O 


Required O O 


Optional O O 


Recommended O O 


Required O O 


Required O O 


Recommended O O 


O 


O 


fu: 


gb: 


If a window is resizable, any sizing changes should be allocated to the 
pane containing scrolling lists or text fields whose displayed length is 
less than their stored length. If both panes contain scrollable controls, 
size changes should be distributed evenly between the two panes. If 
neither pane contains scrollable controls, the window should not be 
resizable. 


The expandable window should have one button that changes its label 
based on the state of the window. 


The expand button should have two labels that reflect the two states 
of the expandable window accurately. The current label should 
indicate to the user what will happen if the user clicks the button. 


Examples of possible labels are Basic and Options, Expand and 
Contract, and More and Less. 


The expand button may contain a graphic in addition to the label. 
This graphic should indicate the direction in which the window will 
expand or contract. 


The button should appear in the lower left-hand corner of the window 
or dialog box for expansion in the vertical direction and in the lower- 
right hand corner for expansion in the horizontal direction. 


If the window or dialog box contains a scrolling list positioned to the 
far right side of the pane, do not align the drawn button with the 
scroll bar. For example, the button should be aligned with the list, not 
the scroll bar. 


Applications must remember the state of each window or dialog box 
(expanded or not expanded) independently (not collectively). The state 
should be changed only by the user and should always be preserved 
until explicitly altered by the user. 


Applications should remember the state of each expandable window 
or dialog box across sessions, so that users don’t have to manually 
configure the expandable windows each time the application is run. 
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y nan 
Recommended O O O 


Optional O O O 


gd: 


Optional O O O of 


Recommended O O O 


gg: 


If appropriate, applications can provide a mechanism, as an option, to 
allow users to set the state of an expandable window globally for the 
application. This would be part of the application’s Options. 


Messages displayed by your application do not assume that the user 
has any expert knowledge about computer systems in general, or the 
UNIX system in particular. 


It is appropriate to assume that the user has knowledge about basic 
terms used within the desktop, such as files or programs. Such 
knowledge can be assumed to have been learned by the user through 
Tutorials, online help, and user documentation. However, terminology 
that is typically understood only by an expert or frequent computer 
user should be avoided unless the application is specifically targeted 
at computer professionals. Likewise, messages returned to your 
application by the underlying operating system should not be passed 
through to the user, but instead, should be “translated” into language 
that can be understood by the novice user. 


Error messages displayed by your application indicate the possible 
cause of the error and indicate the possible actions the user can take 
in response. 


Your application uses audio feedback, in addition to any messages 
displayed, to signal error conditions and events. 


Don't rely on error messages from the kernel and library routines. 
Error messages from kernel and library routines are normally not 
seen by the user, and even when the user does see them, they are 
usually too low-level and cryptic to be understood by 
nonprogrammers. Applications should check for error conditions and 
use an error dialog box to present an appropriate error message in 
terms of the user’s actions and intentions. 


Your application displays a confirmation or warning message dialog 
box to the user when an action instigated by the user will be 
irreversible and potentially destructive with respect to the 
information stored within the system or the operation of the system 
or desktop environment. 
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y nan 
Recommended O O O JI: 


Recommended O O O QF: 


Recommended O O O Qk: 


Optional O O O QI: 


Certification Checklist 


Urgent conditions that require immediate attention by the user, no 
matter which application or desktop service the user is currently 
accessing, are brought to the user's attention using audiovisual 
notification. The alarm is signaled in the current workspace 
regardless of the workspace in which the application resides. 


Some applications, such as network monitors or stock watch 
programs, may need to grab the user’s immediate attention to some 
event. Both visual and audio alarms should be used to signal the user. 
The user should be able to acknowledge the alarm and cause it to 
cease. 


Your application uses footer messages only to communicate status, 
progress, or information (help) messages. It does not use the footer to 
present error messages. 


The footer is a good location for prompt messages that help the user 
to determine how to choose options within a window or fill out a 
particular field. It should not be used to present error messages to the 
user or informational messages that are important for the user to 
notice. These should be presented in the appropriate style message 
dialog box. 


Your application provides a Help button in all message dialog boxes, 
except those that contain self-explanatory messages. 


Applications should be designed with both the expert and novice user 
in mind. The novice user must be able to access additional 
information clarifying the message, the circumstances under which it 
might have been displayed, and what the user should do in response 
to the message. 


Your application uses the appropriate style dialog box for the display 
of messages to the user. 


An information dialog box is used to display status, completion of 
activity, or other informative types of messages to which the user 
need not necessarily respond other than to acknowledge having read 
the message. 


10 


Optional O O O QM: 


y n/aon 
Optional O O O Qn: 


Optional O O O QO: 


Minimally, information dialog boxes should have an OK button so 
that the user can dismiss the dialog box. If there is additional 
information available about the situations under which the message 
is displayed or other references for the topic to which the message 
relates, then a Help button should be included. 


An error dialog box is used to display error messages to the user. The 
error dialog box displayed states what the error is and specifies why 
it occurred. The error dialog box contains a Help button so that the 
user may get additional information, unless the message is self- 
explanatory. The error dialog box contains an OK button that 
dismisses the dialog box. 


A Cancel button is not required for error dialog boxes unless the error 
resulted in the suspension of an activity that was in progress. In this 
case, the message should indicate whether the user has the option to 
continue the activity or stop it, and the buttons for the dialog box 
should be Continue, Cancel, and Help. In general, error dialog boxes 
should not be modal unless it is critical that the user not continue 
interacting with the application until the user has acknowledged 
having read the error message. 


A question dialog box is used to ask questions of the user. The 
question is clearly worded to indicate what a Yes response or a No 
response means. The buttons displayed are Yes, No, and Help. Help 
provides additional information as to what the application will do in 
response to a Yes or No choice. 


Where possible, you should extend the label for the Yes and No 
buttons to make it clear what action will be performed as a result of 
choosing either option. For example, if the user has made changes to 
a document and has not saved these but has chosen the application's 
Exit option, you might display a question dialog box that asks 
“Changes have not been saved. Do you want to save these before 
exiting?” The buttons should be Save, Discard, Cancel, and Help. 
These labels allow the more experienced user to click the correct 
button without having to carefully read the question and relate it to 
the button labels. 


A warning dialog box is used to communicate the consequences of an 
action requested by the user that may result in the loss of data, 
system or application accessibility, or some other undesirable event. 
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y nan 
Optional O O O 9G: 


Optional O O O OF: 


Optional O O O QS: 


The dialog box is presented before the action is performed and offers 
the user the opportunity to cancel the requested operation. The 
buttons displayed are Yes, No, and Help, or Continue, Cancel, and 
Help. Help provides additional information on the consequences of 
performing the action requested. 


The use of Yes and No, or Continue and Cancel, depends on the 
wording of your message. The labels for Yes and No should be 
extended as suggested previously. Continue may be replaced with a 
label more specific to the action that will be performed. 


A working dialog box is used to display in-progress information to the 
user when this information is not displayed in the footer of your 
application's window. The dialog box contains a Stop button that 
allows the user to terminate the activity. The operation is terminated 
at the next appropriate breakpoint, and a confirmation might be 
displayed asking whether the user really wants to stop the activity. 
The confirmation message might state the consequences of stopping 
the action. 


Your application writes error messages to the Common Desktop 
Environment error log when it is not appropriate to display these to 
the user in a message dialog box, but when the message may 
nevertheless be useful in diagnosing problems. 


You might also write error messages that are displayed to the user in 
the error log if it would be valuable to the user or an administrator to 
refer to these messages at some later time. Messages written to the 
error log should provide additional information about the error and 
should state the context in which the error occurred. 


Informational messages should be left aligned and displayed in a light 
font in keeping with their unobtrusive nature. Note that the margin 
where informational messages are displayed should not accept mouse 
focus. 


Progress messages should normally be displayed only while the 
operation is in progress. Notices and other information that is no 
longer valid should be removed within a few seconds to avoid 
confusion about whether or not the information is current. 
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Recommended O O O St: 


y nan 
Recommended O O O Qu: 


Recommended O O O QV: 


If any command chosen by the user is expected to take longer than 2 
seconds to complete, but less than 10 seconds, your application 
displays the standard busy pointer as feedback that the command is 
executing. 


The user must receive assurance that your application has “heard” 
the request and is working on it. If the results of the request cannot 
be displayed immediately, some feedback must be provided. The busy 
pointer should be displayed within 0.5 seconds of execution of the 
command. 


If any command chosen by the user is expected to take longer than 10 
seconds to complete, your application displays a working dialog box or 
other feedback of similar character that indicates that the application 
is working on the request. The feedback should reveal progress 
toward completion of the activity. 


If an activity is expected to take a significant amount of time (10 
seconds or more), your application should display feedback stronger 
than the busy pointer. Displaying the busy pointer for long amounts 
of time may lead the user to conclude that the application has become 
“nung.” A progress indicator should be displayed in these scenarios 
that indicates that the application is still functioning and is working 
on the user's request. The progress indicator should show how much 
of the activity has been completed and what amount remains. 


When your application displays work-in-progress feedback to the user, 
it does not block access to other applications and services within the 
desktop environment. 


Multitasking should always be supported and, as such, your 
application should allow the user to access other services while it is 
busy performing some activity. Preferably, the user is also able to 
access other features within your application even though it is 
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currently working on another request. When this is supported, your 
application should display an enhanced busy pointer that indicates 
that the application is busy but still willing to accept input. 


Contols, Groups, and Models 


CheckButton 


Required O O O 7-1: 


y nan 


Required O O O 7-2: 


Required O O O 7-3: 


Required O O O 7-4& 


Your application uses check buttons to select settings that are not 
mutually exclusive. A check button graphically indicates its state 
with the presence or absence of a check mark. 


A check button is used to select settings that are not mutually 
exclusive. The user needs to know whether the button is set or not. 


When the user presses BSelect in a check button, the check button is 
armed. If the check button was previously unset, it is shown in the 
set state. If the check button was previously set, it is shown in the 
unset state. 


BSelect Press arms a check button and shows the result of activating 
it by releasing BSelect. 


When the user releases BSelect in the same check button in which 
the press occurred: 


¢ |f the check button was previously unset, it is set. 


¢ If the check button was previously set, it is unset. 


In all cases the check button is disarmed, and, if the check button is 
in a menu, the menu is unposted. 


BSelect Release activates a check button. 


When the user presses the Enter or Return key in a check button, if 
the check button is in a window with a default action, the default 
action is activated. If the check button is in a menu: 


e |f the check button was previously unset, it is set. 
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ComboBox 


y 
Required O 


Required O 


Recommended O 


Recommended O 


Recommended O 


Recommended O 


Recommended O 


n/a 


O 


@) 


O 


n 


O 


O 


O Q9z: 


hb: 


hc: 


¢ If the check button was previously set, it is unset. 


¢ In both cases, the check button is disarmed, and the menu is 
unposted. 


The Enter and Return keys perform the default action of a window or 
activate a check button in a menu. 


When the user presses the Select key or Spacebar in a check button, 
if the check button was previously unset, it is set. If the check button 
was previously set, it is unset. In both cases, the check button is 
disarmed, and, if the check button is in a menu, the menu is 
unposted. 


The Select key and Spacebar activate a check button. 


Ina list that can be scrolled, such as a scrollable list box, do not allow 
the cursor to wrap. 


Provide vertical scroll bars when some of the data is not visible in the 
combo box. 


Provide horizontal scroll bars when elements are wider than the list 
box. 


Display the elements in an order that is meaningful to the user. 


Display an initial value from the list in the text-entry field. Display 
selected emphasis on the initial value so that typed text will replace 
the value. 


Make the combination box large enough to display a minimum of six 
list items at a time. 


When a user increases the size of the window in which the combo box 
is displayed, increase the number of items displayed in the combo 
box. 
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CommandBox 


Required O O O 7-6: 


Required O O O 7-7: 


y nan 
Required O O O 7-8: 


Required O O O 7-9: 


FileSelec tonBox 


Required O O O 7-10: 


When a user decreases the size of the window in which the combo box 
is displayed, decrease the number of items displayed in the combo 
box. AS a minimum, reduce the combo box to the text-entry field and 
a list box with one entry displayed. If the window is sized so that two 
list items cannot be displayed, clip the combo box. 


If your application uses a command box, it is composed of a text 
component with a command-line prompt for text input and a list 
component for a command history area. The list uses either the single 
selection or browse selection model. 


This specification ensures the consistent appearance and operation of 
a command box across applications. 


When an element of a command box list is selected, its contents are 
placed in the text area. 


This specification provides a convenient way of selecting a previously 
entered command. 


The list navigation actions Up Arrow, Down Arrow, Control+Begin, 
and Control+énd are available from the text component for moving 
the cursored element within the list and thus changing the contents 
of the text. 


These actions provide a convenient way to choose a command from 
the list while focus remains in the text component. 


The default action of the command box passes the command in the 
text area to the application for execution and adds the command to 
the end of the list. 


Maintaining a history of commands provides a convenient means of 
entering often-used commands. 


If your application uses a file selection dialog box, it contains the 
following components: 
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250 


Recommended O O 


y nia 
Recommended O O 


Required O O 


Recommended O O 


Required O O 


he: 


hf: 


hg: 


hh: 


hi: 


e A directory text component showing the current directory path. 
The user can edit the directory text component and press Return or 
Enter to change the current directory. 


© For applications that allow saving to different formats, an option 
button allowing users to specify the format when saving a file. 


© A file name text component for displaying and editing a file name. 
This component is optional when the file selection box is used to 
choose an existing file or directory. 


© A group of push buttons, including a command button, and U pdate, 
Cancel, and Help buttons. The command button is typically labeled 
Open or Save, but if there is another label that better describes the 
resulting action (Such as Include), that label should be used. 
Activating the command button carries out the corresponding 
action and dismisses the file selection box. 


When the file selection box is used to specify an existing file (for 
example, to open a document), the command button is normally 
labeled Open and it should be the default action. 


If the Update button is activated while a directory is selected in the 
contents list, the directory is opened, its contents are displayed in the 
contents list, and the directory text is updated. 


If the Open button is activated while the appropriate file is selected in 
the contents list, the file is utilized by the application and the file 
selection box is dismissed. 


When the file selection dialog box is used to choose an existing 
directory (for example, to install a set of files into the chosen 
directory) or to specify a new directory, the command button should 
be given an appropriate label, such as Install, Choose, Create, or OK. 
If this button is activated while the appropriate directory is selected 
in the contents list, the directory is utilized by the application and the 
file selection box is dismissed. 


When the file selection dialog box is used to choose an existing 
directory, there must also be an additional button, labeled Update, 
that is enabled whenever a directory is selected in the contents list, 
and opens the directory. This Update button is the default action. 
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Required O O O hj: 


Optional O O O hk: 


Required O O © HI: 


7-11: 


y n/aon 
Required O O O 7-12: 


Required O O O 7-13: 


7-14: 


When the file selection dialog box is used to specify a new file name 

(for example, a Save As dialog box), the command button is normally 
labeled Save and is the default action. This specification ensures the 
uniform appearance of a file selection box across applications. 


When the file selection dialog box is used to choose an existing file, 
files are shown in the contents list but they are all disabled. Double- 
clicking BSelect on a disabled file name has no effect. 


The normal text navigation and editing functions are available in the 
text components for moving the cursor within each text component 
and changing the contents of the text. 


These actions provide a convenient way to choose a directory or file 
name from the corresponding list while focus remains in the text 
component. 


This item has been deleted. 


Double-clicking BSelect on an item in the contents list selects that 
item and activates the default action. In all cases, double-clicking 
BSelect on a directory in the contents list opens that directory and 
displays its contents in the contents list (the default action is Open). 


¢ When the file selection box is used to choose an existing file, 
double-clicking BSelect on an appropriate file in the contents list 
chooses that file and dismisses the file selection box (the default 
action is Open). 


® When the file selection box is used to choose an existing directory 
or to specify a new directory or file, the files list should not appear. 


The normal text navigation and editing functions are available in the 
text components for moving the cursor within each text component 
and changing the contents of the text. 


This item has been deleted. 
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Optional O O © 7-15: Your application allows the user to select a file by scrolling through 
the list of file names and selecting the desired file or by entering the 
file name directly into the file selection text component. Selecting a 
file from the list causes that file name to appear in the file selection 
text area. 


This method of selecting a file needs to be consistent across 
applications. 


Required O O © 7-16: Your application makes use of the selection when one of the following 
occurs: 


* The user activates the command push button while an appropriate 
item is selected in the contents list. 


* The user double-clicks BSelect on an appropriate file in the 
contents list. 


* The user presses Return or Enter while the file name text 
component has the keyboard focus and contains an appropriate 
item. 


y n/faon 
Required O O O 7-17: The file selection box displays the contents of a directory in the 
contents list when the file selection box is initialized, when the user 
presses Enter or Return in the directory text component, and when 
the user opens a directory in the contents list. The contents list is 
updated each time the contents of the directory changes. 


This specification ensures the consistent operation of a directory and 
file search in a file selection box. 


Recommended O O © hm: If the user has opened the application without supplying a file name 
argument, the Open dialog box should use the user’s home directory 
as the default directory. 
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Required O O 


Optional O O 


Optional O O 


Optional O O 


y nia 
Optional O O 


Optional O O 


Optional O O 


hn: 


ho: 


hp: 


hq: 


hr: 


hs: 


ht: 


An exception to this rule might be made if a clearly more useful 
directory can be identified; for example, the icon editor might default 
to HomeDirectory/.dt/icons. For Applications that allow editing, 
never default to a directory in which the user does not have read and 
write permission, such as /usr/dt/bin. 


If the user has opened the application with a file name argument, the 
Open dialog box should default to the directory in which that file 
resides. 


When using the file selection dialog box in Save As capacity, providea 
default name of Untitled, place the location cursor in the file name 
field and highlight the file name text to create a “delete pending type- 
in” mode. If the current directory already has a file of that name, 
create a name Untitled2, and so forth. 


When using the file selection dialog box in a Save As capacity, add a 
file name extension if the application supports file typing by 
extension, and make this extension visible in the file name field. Do 
not highlight the extension to create a “delete pending type-in” mode, 
but allow users to modify the extension or delete it explicitly. 


The file selection dialog box should come up in a directory that makes 
sense for the task. For example, when saving a new file from an 
editor, the file selection box should come up in the user’s home 
directory. If the user navigates to some other directory within the file 
selection box, the application should remember that directory the 
next time it is brought up. 


Users should never be allowed to overwrite an existing file through 
the file selection box without a warning dialog box prompt. 


Keyboard focus should be placed in the file name field each time users 
bring up a file selection dialog box. 


Directory and file name lists should be presented alphabetically, case 
insensitive. The first item on the directory list should be the parent 
directory and it should be labeled “..”. 
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Optional O O O hu: Labels should be dear. In the English language, use the following 
labels for the file selection dialog box fields and lists: 
Table 10-4F ile Selection Dialog Box Labels 
Component Label 
Directory text field Enter Path or Folder Name: 
Filter text Field Filter: 
Directory list Folders: 
Contents list Files: 
File text field Enter File Name:* 

Optional O O O hv: Optionally, application developers can make this label more 
instructive and specific, such as Enter File to Open for Open dialog 
boxes. 

These labels should be the default labels. If they are not set by 
default, you need to set them through resources in your application's 
app-defaults file. 
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List 


y n/aon 
Required O O O 7-18: 


Required O O O 7-19: 


Required O O O 7-20: 


Required O O O 7-21: 


Within a list component, your application uses the Up Arrow key to 
move the location cursor to the previous item in the list and the Down 
Arrow key to move the location cursor to the next item in the list. In 
a scrollable list, the Left Arrow key scrolls the list one character to 
the left, and the Right Arrow key scrolls the list one character to the 
right. 


The arrow keys provide a consistent means of moving the location 
cursor within a list component. 


Within a list component, your application uses Control+Begin to move 
the location cursor to the first item in the list and Control+ nd to 
move the location cursor to the last item in the list. In a scrollable 
list, the Begin key moves the horizontal scroll region so that the 
leftmost edge of the list is visible, and the End key moves the 
horizontal scroll region so that the rightmost edge of the list is visible. 


These keys offer a convenient mechanism for moving the location 
cursor quickly through a list. 


Within a scrollable list, the Page Up key moves the location cursor to 
the item one page up in the list, and the Page Down key moves the 
location cursor to the item one page down in the list. In a scrollable 
list, the Page Left key (or Control+Page Up) scrolls the list one page 
to the left, and the Page Right key (or Control+P age Down) scrolls the 
list one page to the right. 


These keys offer a convenient mechanism for paging through a list. 


Within a list component, your application uses BSelect Click 2 to 
select the item that was double-clicked and then initiate any default 
action for the window. 


Double-clicking using BSelect provides a consistent way of activating 
the default action for a list. 
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Option Button 


y n/aon 
Required O O O 7-22: 


Required O O O 7-23: 


Required O O O 7-24: 


Required O O O 7-25: 


Paned Window 
Required O O O 7-26: 


If your application uses option buttons, the label for the button is the 
last selection made from the option button. 


An option button is used to post an option menu which allows the 
user to select from a number of choices. The label of an option button 
needs to display the most recent selection from the associated option 
menu. 


When the user presses BSelect or BMenu in an option button, the 
associated option menu is posted. 


BSelect Press is a consistent way of activating an option button. 


When the user releases BSelect or BMenu within the same option 
button that the press occurred in, the associated option menu is 
posted if it was not posted at the time of the press. When the user 
releases BSelect or BMenu outside of the option button, the 
associated option menu is unposted. 


BSelect Release or BMenu Release posts or unposts an option menu, 
depending on whether the release occurs inside the option button and 
whether the option menu was posted at the time of the press. 


When the user presses the Select key or Spacebar in an option button, 
the associated option menu is posted. 


The Select key or Spacebar posts an option menu from the keyboard. 


If your application uses paned windows, they are composed of any 
number of groups of components, called panes, each separated by a 
sash and a separator. The panes, sashes, and separators are grouped 
linearly, either horizontally or vertically. A sash is the handle on a 
separator between two panes that is used to adjust the position of the 
separator. 


This specification ensures the consistent appearance of a paned 
window across applications. 
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Panel 


y nan 
Required O O O 7-27: 


Push Button 


Required O O O 7-28: 


Required O O O 7-29: 


Required O O O 7-30: 


Radio Button 


Required O O O 7-31: 


The Down Arrow, Left Arrow, Right Arrow, and Up Arrow directional 
keys navigate among components in a panel. 


A panel group organizes a collection of basic controls in a horizontal, 
vertical, or two-dimensional layout. The directional keys are used to 
navigate among the controls. 


When the user presses BSelect in a push button, the push button is 
armed. When the user releases BSelect in the same push button that 
the press occurred in, the push button is disarmed and activated. 
When the user releases BSelect outside the push button, the push 
button is disarmed but not activated. 


BSelect provides a consistent means of activating a push button. 


When the user presses the Enter or Return key in a push button that 
is in a window with a default action, the push button is activated. 
When the user presses the Enter or Return key in a push button ina 
menu, the push button is activated and the menu is unposted. 


The Enter and Return keys activate a dialog box or a push button in 
a menu. 


When the user presses the Select key or Spacebar in a push button, 
the push button is activated. If the push button is in a menu, the 
menu is unposted. 


The Select key and Spacebar activate a push button. 


If your application uses radio buttons, each button graphically 
indicates its state. 


Radio buttons are used to represent a panel of mutually exclusive 
selections. The user needs to know which button in the panel is set. 
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y nan 


Required O O O 7-32: 


Required O O O 7-33: 


Required O O O 7-34: 


Required O O O 7-35: 


Sash 
Required O O O 7-36: 


When the user presses BSelect in a radio button, the radio button is 
armed. If the radio button was previously unset, it is shown in the set 
state. 


BSelect Press arms a radio button and shows the result of activating 
it by releasing BSelect. 


When the user releases BSelect in the same radio button that the 
press occurred in and the radio button was previously unset, it is set, 
and any other radio button in the same panel that was previously set 
is unset. The radio button is disarmed, and, if the radio button is ina 
menu, the menu is unposted. 


BSelect Release activates a radio button. 


When the user presses the Enter or Return key in a radio button, if 
the radio button is in a window with a default action, the default 
action is activated. If the radio button is in a menu: 


¢ |f the radio button was previously unset, it is set, and any other 
radio button in the same pane! that was previously set is unset. 


* The radio button is disarmed, and the menu is unposted. 


The Enter and Return keys perform the default action of a window or 
activate a radio button in a menu. 


When the user presses the Select key or Spacebar in a radio button, if 
the radio button was previously unset, it is set, and any other radio 

button in the same panel that was previously set is unset. The radio 
button is disarmed, and, if the radio button is in a menu, the menu is 
unposted. 


The Select key and Spacebar activate a radio button. 


Within a paned window, your application uses a sash to adjust the 
position of a separator, which adjusts the sizes of the panes next to it. 
As a sash is moved, the pane in the direction of the sash movement 
gets smaller and the opposite pane gets larger by an equal amount. 


CDE: Style Guide and Certification Checklist 


10= 


y nan 
Required O O O 7-37: 


Required O O O 7-38: 


Required O O O 7-39: 


Scale 
Required O O O 7-40: 


Required O O O 7-41: 


This specification results in the uniform operation of a paned window 
across applications. 


Within a sash, BSelect Motion or BTransfer Motion causes the sash to 
track the movement of the pointer. |n a vertically oriented paned 
window, the sash tracks the vertical position of the pointer. In a 
horizontally oriented paned window, the pane tracks the horizontal 
position of the pointer. 


BSelect, mouse button 1, and BTransfer, mouse button 2, provide a 
consistent means of moving a sash in a paned window using the 
mouse. 


The Up Arrow and Down Arrow keys (for a sash that can move 
vertically) and the Left Arrow and Right Arrow keys (for a sash that 
can move horizontally) move the sash one increment in the specified 
direction. 


The arrow keys offer a uniform means of moving a sash in a paned 
window. 


Control+Up Arrow and Control +Down Arrow (for a sash that can 
move vertically) and Control+Left Arrow and Control+Right Arrow 
(for a sash that can move horizontally) move the sash one large 
increment in the specified direction. 


These keys provide a convenient way of moving a sash quickly ina 
paned window. 


If a scale has arrow buttons, your application uses BSelect Press in 
an arrow button to move the slider one increment in the direction of 
the side of the slider on which the button was pressed and 
autorepeats until the button is released. 


BSelect Press provides a consistent means of adjusting a scale 
component using the mouse. 


In a scale trough, if the scale has tick marks, BSelect Press moves the 
slider one major tick mark in the direction of the side of the slider on 
which the trough was pressed and autorepeats until the button is 
released. If the scale does not have tick marks, BSelect Press in the 
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260 


y nia 
Required O O 


Required O O 


Required O O 


Required O O 


Required O O 


7-42 


7-43: 


7-44: 


trough moves the slider one large increment in the direction of the 
side of the slider on which the trough was pressed and autorepeats 
until the button is released. 


BSelect Press provides a consistent means of adjusting a scale 
component using the mouse. 


: Within a scale slider, BSelect Motion causes the slider to track the 


position of the pointer. In a vertical scale, the slider tracks the 
vertical position of the pointer. In a horizontal scale, the slider tracks 
the horizontal position of the pointer. 


BSelect Motion offers a convenient way to adjust a scale component 
precisely using the mouse. 


Within a scale slider or trough, BTransfer Motion positions the slider 
to the point of the button press and then causes the slider to track the 
position of the pointer. In a vertical scale, the slider tracks the 
vertical position of the pointer. In a horizontal scale, the slider tracks 
the horizontal position of the pointer. 


BTransfer Motion provides another convenient way to adjust a scale 
component precisely using the mouse. 


If a mouse-based sliding action is in progress, the Cancel key cancels 
the sliding action and returns the slider to its position prior to the 
start of the sliding operation. 


The Cancel key provides a consistent way for the user to cancel a 
mouse-based sliding action. 


: In a vertical scale, the Up Arrow and Down Arrow keys move the 


slider one increment in the specified direction. In a horizontal scale, 
the Left Arrow and Right Arrow keys move the slider one increment 
in the specified direction. 


The arrow keys provide a uniform way of adjusting the slider in a 
scale component using the keyboard. 


:1n a vertical scale, Control+Up Arrow and Control+Down Arrow move 


the slider one large increment in the specified direction. In a 
horizontal scale, Control +L eft Arrow and Control+Right Arrow move 
the slider one large increment in the specified direction. 
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y n/a n 
Required O O O 


Sc roliBar 


Required O O O 


Required O O O 


Required O O O 


Required O O O 


7-47: 


7-48: 


7-49: 


7-51: 


These keys provide a convenient way of adjusting the slider in a scale 
component quickly using the keyboard. 


Your application uses the Begin key or Control+Begin to move the 
slider to its minimum value. The End key or Control+End moves the 
Slider to its maximum value. 


These keys provide a convenient mechanism for setting a scale to its 
minimum or maximum value using the keyboard. 


Within a scroll bar, your application uses BSelect Press in an arrow 
button to move the slider one increment in the direction of the side of 
the slider on which the button was pressed and autorepeats until the 
button is released. 


BSelect Press provides a consistent means of adjusting a scroll bar 
using the mouse. 


In the trough of a scroll bar, BSelect Press moves the slider one page 
in the direction of the side of the slider on which the trough was 
pressed and autorepeats until the button is released. 


BSelect Press provides a consistent means of adjusting a scroll bar 
using the mouse. 


: Within a scrollbar slider, BSelect Motion causes the slider to track the 


position of the pointer. In a vertical scroll bar, the slider tracks the 
vertical position of the pointer. In a horizontal scroll bar, the slider 
tracks the horizontal position of the pointer. 


BSelect Motion offers a convenient way to adjust a scroll bar precisely 
using the mouse. 


Within a scrollbar slider or trough, BTransfer Motion positions the 
slider to the point of the button press and then causes the slider to 
track the position of the pointer. In a vertical scroll bar, the slider 
tracks the vertical position of the pointer. In a horizontal scroll bar, 
the slider tracks the horizontal position of the pointer. 


BTransfer Motion offers another convenient way to adjust a scroll bar 
precisely using the mouse. 
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y nia 


Required O O 


Required O O 


Required O O 


Required O O 


Required O O 


7-52: 


7-53: 


7-55: 


7-56: 


If a mouse-based scrolling action is in progress, pressing the Cancel 
key cancels the scrolling action and returns the slider to its position 
prior to the start of the scrolling operation. 


The Cancel key provides a consistent way for the user to cancel a 
mouse-based scrolling action. 


In a vertical scroll bar, the Up Arrow and Down Arrow keys move the 
slider one increment in the specified direction. In a horizontal scroll 
bar, the Left Arrow and Right Arrow keys move the slider one 
increment in the specified direction. 


The arrow keys provide a uniform means of adjusting a scroll bar 
using the keyboard. 


:1n a vertical scroll bar, Control+Up Arrow and Control+Down Arrow 


move the slider one large increment in the specified direction. 
Control+Left Arrow and Control+Right Arrow move the slider one 
large increment in the specified direction. 


These keys provide a convenient way of adjusting a scroll bar quickly 
using the keyboard. 


Your application uses the Page Up and Page Down keys to move the 
slider in a vertical scroll bar one page in the specified direction. The 
Page Left key (or Control+Page Up) and the Page Right key (or 
Control+Page Down) move the slider in a horizontal scroll bar one 
page in the specified direction. 


These keys allow for the convenient movement of the slider in a scroll 
bar using the keyboard. 


Your application uses the Begin key or Control+Begin to move the 
slider to the minimum value. The End key or Control+End moves the 
slider to the maximum value. 


These keys offer a convenient mechanism for setting a scroll bar to its 
minimum or maximum value using the keyboard. 
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Selec tionBox 


y n/aon 
Required O O O 7-57: 


Required O O O 7-58: 


SpinBox 


Required O O O hw: 


Required O O O hx: 


If your application uses a selection box, it is composed of at least a 
text component for the selected alternative and a list component 
above the text component for presenting alternatives. The list uses 
either the single selection or browse selection model. Selecting an 
element from the list places the selected element in the text 
component. 


This specification ensures the consistent appearance and operation of 
a selection box across applications. 


The list navigation actions Up Arrow, Down Arrow, Control+Begin, 
and Control+End are available from the text component for moving 
the cursored element within the list and thus changing the contents 
of the text. 


These actions provide a convenient way to choose an element from the 
list while focus remains in the text component. 


Present the items as a ring of items that wrap. For example, if a user 
is at the largest number and presses the up arrow, the smallest 
number is displayed and vice versa so that the user can spin through 
all the items by pressing the same arrow. 


Move through the items in a spin box as shown in Table 10-5 on 
page 264. 
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264 


y nan 


Recommended O O O hy: 


Recommended O O O 


Recommended O O O 


Table 10-5Navigation in a Spin Box 


Movement Keys Example 

Toward the left arrow, down Chronological: If Tuesday is displayed, 
beginning of the arrow move to Monday when the user presses 
list the left or down arrow. 


Magnitude: If 15 is displayed, move to 
14 when the user presses the left or 
down arrow. 


Toward the end of _ right arrow, up Chronological: If Tuesday is displayed, 
the list arrow move to Wednesday when the user 


presses the right or up arrow. 


Magnitude: If 15 is displayed, move to 
16 when the user presses the right or 
up arrow. 


hz: 


Values can be set using the arrow buttons or through keyboard input. 
Values should be evaluated immediately upon entry. If a value is 
entered that is already in the list, scroll to the position of that entry 
in the list. 


If entry of non-listed items is permitted, use the following behavior. 
When a new value is entered, scroll the list to the position 
appropriate for the new entry. If the user scrolls off the new entry, 
scroll to the next appropriate value in the list and the keyboard- 
entered value is lost. 


On entry of an invalid value, an auditory warning and error message 
should be provided. 
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Text 


y n/aon 
Required O O O 7-59: 


Required O O O 7-60: 


Required O O O 7-61: 


Required O O O 7-62: 


Required O O O 7-63: 


In a multiline text component, the Up Arrow key moves the location 
cursor up one line, and the Down Arrow key moves the location cursor 
down one line. [In a single-line text component, the Up Arrow key 
navigates upward to the previous component, and the Down Arrow 
key navigates downward to the next component, if the text component 
is designed to act like a basic control. 


The up and down arrow keys provide a uniform means of navigation 
within text components. 


The Left Arrow key moves the location cursor left one character, and 
the Right Arrow key moves the location cursor right one character. 


The Left Arrow and Right Arrow keys offer a consistent way of 
navigating within text components. 


In a text component used generally to hold multiple words, 
Control+Right Arrow moves the location cursor to the right by a word, 
and Control+Left Arrow moves the location cursor to the left by a 
word. 


Control+Right Arrow and Control+Left Arrow provide a uniform way 
of navigating by words in a text component. Moving right by a word 
means that the location cursor is placed before the first character that 
is not a space, tab, or newline character after the next space, tab, or 
newline. Moving left by a word means that the location cursor is 
placed after the first space, tab, or newline character preceding the 
first previous character that is not a space, tab, or newline. 


In a text component used generally to hold multiple words, the Begin 
key moves the location cursor to the beginning of the line, and the 
End key moves the location cursor to the end of the line. 


These keys allow the user to move quickly to the beginning or end of 
a line of text in a text component. 


In a multiline text component, Control+Begin moves the location 
cursor to the beginning of the file, and Control+End moves the 
location cursor to the end of the file. 
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y n/aon 
Required O O O 7-64: 


Required O O O 7-65: 


Required O O O 7-66: 


Required O O O 7-67: 


Required O O O 7-68: 


These keys permit the user to move quickly to the beginning or end of 
a file in a text component. 


Your application uses Spacebar or Shift+Spacebar to insert a space in 
a text component. Modifying these with Control invokes the normal 
selection function. 


This specification ensures that selection is available from the 
keyboard in a text component. 


Return in a multiline text component inserts a carriage return. The 
Enter key or Control+Return invokes the default action. 


This specification ensures that activation is available from the 
keyboard in a text component. 


In a multiline text component, Tab is used for tabbing. In a single-line 
text component, Tab is used either for tabbing or to move to the next 
field. 


Tab is used for tabbing in multiline text. 


If a text component supports replace mode, insert toggles between 
insert mode and replace mode. 


By default, the component starts in insert mode, where the location 
cursor is between two characters. In insert mode, typing a character 
inserts the character at the position of the location cursor. 


In replace mode, the location cursor is on a character. Typing a 
character replaces the current character with that newly entered 
character and moves the location cursor to the next character, 
selecting it. 


These rules ensure the uniform operation of a text component with a 
replace mode. 


Your application uses BSelect Click 2 to select text a word at a time. 


Double-clicking with mouse button 1 provides a convenient 
mechanism for selecting words in a text component. 
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Gauge 


y nia 
Required O O 


Optional O O 


Accessibility 
Recommended O O 
Recommended O O 


Recommended O O 


=) 


Recommended O O O 


Recommended O 


Recommended O O 


y nia 
Recommended O O 


Recommended O O 


Recommended O O 


=) 


A gauge is similar to a scale except that a gauge is a display-only 
device with no user interactions. The appearance of a gauge is similar 
to a scale, but the gauge lacks a scale slider. 


Despite being a display-only device, a gauge should get keyboard 
focus so that the user can access Help or Settings for that control. 


All application functions are accessible from the keyboard. 
Colors should not be hard coded. 


Graphic attributes, such as line, border, and shadow, should not be 
hard coded. 


Font sizes and styles should not be hard coded. 


All application code uses descriptive names for widgets. Such 
descriptive names for widgets using graphics instead of text (for 
example, palette items and icons) allow screen reading software to 
provide descriptive information to blind users. 


Interactions do not depend upon the assumption that a user will hear 
an audible notification. 


Where appropriate, users can choose to receive cues as audio or visual 
information. 


The application does not overuse or rely exclusively on audible 
information. 


Users can choose to configure the frequency and volume of audible 
cues. 
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Recommended O O © im: Tear-off menus and user configurable menus for key application 
features may be provided for users with language and cognitive 
disabilities. 


y n/ain 
Recommended O O O in: Application keymappings do not conflict with existing system-level 
key mappings reserved for access features in the X Windows server as 
shown in Table 10-6. 


Table 10-6K eyboard Mappings for Server-L evel Access Features 


Keyboard Mapping Reserved For 

Five consecutive clicks of Shift key On/Off for StickyKeys 

Shift key held down 8 seconds On/Off for SlowK eys and RepeatK eys 
Six consecutive clicks of Control key On/Off for screen reader numeric 


keypad functions. 


Six consecutive clicks of Alt key Reserved for future access use 
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Table A-1 Keyboard Functions and Key Engravings 


Function 


Activation 


Backspace 


Backtab 


Beginning of 
data 


Key 
Engraving 
(US 
Keyboard) 


Select, 
spacebar, or 
Control + 
spacebar 


Backspace 


Shift+Tab or 
Backtab 


Control + 
Home 


Description 


Starts the action associated with a component 
(for example, an action choice). 


Deletes one character to the left of the cursor or 
the current selection. 


Moves the cursor to the previous field. The 
cursor is positioned either on the previous 
choice in that field or on the currently set choice 
in that field. The cursor moves from right to left 
and bottom to top. At the top-leftmost field, the 
cursor moves to the bottom-rightmost field. 
Within a text-entry field, backtab moves the 
cursor to the character position defined by the 
previous tab stop. 


Moves the cursor to the top-leftmost position in 
the current field. 
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Table A-1 Keyboard Functions and Key Engravings (Continued) 


Key 
Engraving 
(US 

Function Keyboard) Description 

Beginning of Home Moves the cursor to the leftmost choice in a 

line group of choices, or to the beginning of the 
current line in a text-entry field. 

Cancel Esc or Cancel Removes the window without applying any 
changes that were not previously applied in 
that window. 

Cancel direct Escor Cancel Cancels the direct manipulation operation. 

manipulation 

Clear Delete or no Removes selected element or group of elements 

assignment! from window without compressing the space 
previously occupied by the element or group of 
elements. 
Close Alt+F 4 Closes active window. 
Context- F1, Shift+F1, Displays context-sensitive help for the element 
sensitive help Help relative to the current context, such as the 
cursor position or the process currently in 
progress. 
Copy Control +C, Produces a duplicate of the selected element or 
Control + group of elements and places it on the 
Insert clipboard. 

Cut Control +X, Removes the selected element or group of 
Shift+Delete elements to the clipboard. 


Default action 


Delete next 
character 


Delete 
previous 
character 


Enter, Return 


Delete! 


Backspace 


If the cursor is on a component that can be 
activated, performs that action. 

If the cursor is on a component that does not 
support activation performs the default action 
for that window. 


Deletes the next character in text. 


Deletes the previous character in text. 
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Table A-1 Keyboard Functions and Key Engravings (Continued) 


Key 
Engraving 
(US 

Function Keyboard) Description 

Delete Delete! Removes a selected element or group of 

selection elements and, when appropriate for the window, 
compresses the space it occupied. 

Deselect all Control + Removes selected-state emphasis from all 

Backslash elements in the active window. 

Display drop- Alt+down Displays or removes the list for the drop-down 

down list or arrow list or the drop-down combination box. 

drop-down 

combination 

box 

End of data Control +End Moves the cursor to the bottom-rightmost 
position in the current field. 

End of line End Moves the cursor to the rightmost choice in a 
group of choices, or to the end of the current 
line in a text-entry field. 

Extend Control+Shift | Extends the selection to the beginning of the 

selection to +Home data. 

beginning of 

data 

Extend Shift+H ome Extends the selection to the beginning of a line. 

selection to 

beginning of 

the line 

Extend Shift+down Extends the selection down a line. 

selection arrow 

down 

Extend Control+Shift | Extends the selection to the end of the data. 

selection to + 

end of data End 

Extend Shift+End Extends the selection to the end of a line. 

selection to 

end of line 
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Table A-1 Keyboard Functions and Key Engravings (Continued) 


Key 
Engraving 
(US 
Function Keyboard) Description 
Extend Shift Heft Extends the selection to the left. 
selection to arrow 
the left 
Extend Shift+Page Extends the selection down a page. 
selection Down 
down one 
page 
Extend Control+Shift | Extends the selection a page to the left. 
selection to + 
the left one Page Up 
page 
Extend Control+Shift | Extends the selection a page to the right. 
selection to + 


the right one 
page 

Extend 
selection up 
one page 


Extend 
selection 

down one 
paragraph 
Extend 
selection up 
one paragraph 
Extend 


selection to 
the right 


Extend 
selection 


Page Down 


Shift-+Page 
Up 


Control +Shift 
+ 
down arrow 


Control +Shift 
+up arrow 


Shift+right 
arrow 


Shift+ 
spacebar, 
Control +Shift 
+ 

spacebar 


Extends the selection up one page. 


Extends the selection down one paragraph. 


Extends the selection up one paragraph. 


Extends the selection to the right. 


Extends the selection to the cursor position (not 
valid in text). 
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Table A-1 Keyboard Functions and Key Engravings (Continued) 


Key 
Engraving 
(US 

Function Keyboard) Description 

Extend Shift-+up Extends the selection up a line. 

selection up arrow 

Extend Control+Shift | Extends the selection one word to the left. 

selection Heft arrow 

word left 

Extend Control+Shift | Extends the selection one word to the right. 

selection + 

word right right arrow 

Help F2(inaHelp Displays a brief overview of each action, task, 

(Overview window) or both, that a user can perform within the 

help) window. 

Help index F1l(inaHelp Displays an alphabetic listing of help topics for 
window) an object or a product. 

Help Fl Displays context-sensitive help for the item that 

contains the cursor 

Hide Alt+F9 Removes the window and all associated 

windows from the screen. 

Keyboard help F9(inaHelp Displays a listing of all the key assignments for 
window) an object or a product. 

Maximize Alt+F 10 Enlarges the window to its largest possible size. 

Minimize Alt+F 9 Reduces the window to its smallest possible size 

and removes all of the windows associated with 
that window from the screen. 

Move Alt+F 7 Allows a user to move a window to a different 

location. 

Move cursor Arrow keys Moves the cursor left, right, up, or down. At the 
or Control+ last choice, the cursor wraps. For example, at 
arrow keys the bottom-most choice, the cursor wraps to the 

top-most choice to the right. 

Move cursor F10 Moves the cursor from within a window to its 


to and from 
menu bar 


menu bar or from the menu bar to within the 
window. 
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Table A-1 Keyboard Functions and Key Engravings (Continued) 


Key 
Engraving 
(US 
Function Keyboard) Description 
Move cursor Tab or Moves the cursor to the next field. 
to the next Control +Tab 
field 


Move cursor 
to the 
previous field 


Move cursor 
to the next 
associ ated 
window 
(within a 
window 
family) 


Move cursor 
to the 
previous 
associated 
window 
(within a 
window 
family) 


Move cursor 
forward 
between 
unassociated 
windows 


Move cursor 
between 
window 
families 


Shift+Tab or 
Control +Shift 
+Tab 


Alt+F 6 


Alt+Shift+F 6 


AlIt+£ sc 


Alt+Tab 


Moves the cursor to the previous field. 


Moves the input focus to the next window 
within a window family. 


Moves the input focus to the previous window 
within a window family. 


Moves the input focus forward between the 
groups of associated windows displayed from 
different objects (if more than one object is 
displayed by an object). 


Moves the input focus between open, but not 
hidden, window families. 
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Table A-1 Keyboard Functions and Key Engravings (Continued) 


Function 


Key 
Engraving 
(US 
Keyboard) 


Description 


Move cursor 
backwards 
between 
window 
families 


Move cursor 
to another 
window pane 


New line 
Page down 
Page left 
Page right 
Page up 
Paragraph 
down 
Paragraph up 
Paste 
Pop-up menu 
Redo 


Refresh now 


Alt+Shift+Tab 


F6 


Enter or 
Return 


Page Down 


Control +P age 
Up 


Control +P age 
Down 


Page Up 


Control +down 
arrow 


Control +up 
arrow 


Control -+V or 
Shift nsert 


Shift+F 10 


Shift +Alt+ 
Backspace 


F5, Control+R 


Moves the input focus backwards between open, 
but not hidden, window families. 


Moves the cursor in a clockwise direction from 
one window pane to the next. 


Moves the cursor to the next line of text in 
replace mode or adds a new line in text in 
insert mode. 


A scrolling action that displays information 
below the currently visible window area. 


A scrolling action that displays information to 
the left of the currently visible window area. 


A scrolling action that displays information to 
the right of the currently visible window area. 


A scrolling action that displays information 
above the currently visible window area. 


A scrolling action that displays one paragraph 
below the currently visible window area. 


A scrolling action that displays one paragraph 
above the currently visible window area. 


Copies the contents of the clipboard into the 
window at the specified location. 


Displays a pop-up menu for the indicated 
element or group of selected elements. 


Reverses the effect of the last applied undo 
action. 


Updates the window to reflect the underlying 
data. 
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Table A-1 Keyboard Functions and Key Engravings (Continued) 


Key 
Engraving 
(US 
Function Keyboard) Description 
Restore AIt+F5 Returns the window to the size it was and the 
position it was in before the user minimized or 
maximized the window. 
Select all Control+Slash Selects all elements in active window. 
Select Spacebar (if Selects element on which cursor is positioned. 
element on it is not 
which cursor assigned to 
iS positioned any other 
function) or 
Control + 
spacebar 
Size Alt+F8 Allows a user to change the size of the window. 
Space spacebar or Inserts a space in text. 
Shift+ 
spacebar 
Tab Tab Moves the cursor to the next field. The cursor is 
positioned either on the first choice in that field 
or on the currently set choice in that field. The 
cursor moves from left to right and top to 
bottom. At the bottom-rightmost field, the 
cursor moves to the top-leftmost field. 
Within a text-entry field, Tab moves the cursor 
to the character position defined by the next tab 
stop or resets the tab. 
Toggle Insert Toggles between insert and replace modes. 
between 
insert and 
replace 


modes in text 


entry 
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Table A-1 Keyboard Functions and Key Engravings (Continued) 


Key 
Engraving 
(US 
Function Keyboard) Description 
Toggle in or Shift+F 8 Toggles in or out of keyboard add mode when 
out of extended selection is provided for a view. The 
keyboard add initial deselection is bypassed and the new 
mode when selected objects are added or removed from the 
in extended current group of selected objects. 
selection 
mode 
Tutorial Shift+F 2 (in Displays online educational information. 
a Help 
window) 
Undo Alt+Backspac Reverses the action of the most recently 
e, Control +Z performed user action. 
Using help Shift+F 10 (in Displays help information that describes how to 
a pop-up use the help facility. 
window) 
Window list Control +E sc Displays the window list window from the 
window menu. 
Window menu Alt + Displays window menu. 
Spacebar or 
Shift+£ sc 


Word left 


Word right 


Control Heft 
arrow 


Control -+right 
arrow 


Moves the cursor to the beginning of the word 
to the left of the cursor. 


Moves the cursor to the beginning of the next 
word to the right of the cursor. 


1. Assign the Delete key to either the Delete or Clear function, if only oneis provided. If both Delete and 
Clear functions are provided, assign the Delete key to the Delete function 
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Table A-2 Mnemonic Assignments for menu Choices 


Choice Mnemonic Location 
About A Help menu 
Clear E Edit menu 
Close C File menu and 
Window menu 
Copy C Edit menu 
Copy Link K Edit menu 
Copy To Cc Selected menu 
Cut T Edit menu 
Delete D Object-type menu 
and Edit menu 
Deselect All L Edit menu 
Exit X File menu 
Find F Edit menu 
Icon C View menu 
Include I View menu 
Index | Help menu 
Keyboard K Help menu 
Lower L Window menu 
Maximize X Window menu 
Minimize N Window menu 
Mouse M Help menu 
Mouse and M Help menu 
Keyboard 
Move M Window menu 
Move To M Selected menu 
New N File menu 
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Table A-2 Mnemonic Assignments for menu Choices (Continued) 


Choice 


Occupy All 
Workspaces 


Occupy Workspace 
On Item 

Open 

Overview 

Paste 

Paste Link 

Print 

Promote 
Properties 

Put in Workspace 
Redo 

Reference 
Refresh 

Reselect 

Restore 

Save 

Save as 

Select All 

Select Pasted 
Size 

Sort 

Table of Contents 
Tasks 

Tutorial 

Undo 


Mnemonic 
A 


CraAtonn PUP, HDD MDAWDAVDZzAVDLTFDKS COO CO 


Location 


Window menu 


Window menu 
Help menu 
File menu 
Help menu 
Edit menu 
Edit menu 
File menu 
Edit menu 
Selected menu 
Selected menu 
Edit menu 
Help menu 
View menu 
Edit menu 
Window menu 
File menu 
File menu 
Edit menu 
Edit menu 
Window menu 
View menu 
Help menu 
Help menu 
Help menu 


Edit menu 
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Table A-2 Mnemonic Assignments for menu Choices (Continued) 


Choice Mnemonic 
Unoccupy U 
Workspace 

Using Help U 

View Help TBD 


Location 


Window menu 


Help menu 


View menu 
(object-oriented) 


Table A-3 Keyboard Mappings for Space Bar and Enter Key 


Element Space bar Enter key 

menu Activates current item Activates current item 

pushbutton Activates button Performs default action if default 
action exists for the window 
containing the element 

text field Adds a space Performs default action if default 
action exists for the window 
containing the element 

list item Selects current item Performs default action if default 
action exists for the window 
containing the element 

icon Selects Performs default action if default 


action exists for the window 
containing the element 


CDE: Style Guide and Certification Checklist 


Mouse Functions B 


On a one, two-, or three- button mouse, the mouse buttons are assigned to 
various functions which are defined below. 


Some two-button mice use chording as a way to simulate a third mouse 
button. If so, treat as a three-button mouse, where mouse button 3 is 
mouse button 1+mouse button 2 (chorded). 


Motif supports two different mouse models: 


* Separate Selection and Transfer: 


¢ Mouse button 1 is used only for selection and activation. 
¢ Mouse button 2 is used only for data transfer and direct manipulation. 
¢ |ntegrated Selection and Transfer: 
¢ Mouse button 1 is used both for selection and activation and for data 
transfer and direct manipulation. 


The way the mouse buttons are assigned depends upon the number of 
mouse buttons available, as well as whether selection and transfer are 
integrated or are separate. 


Regardless of the way that the buttons are assigned, a number of "virtual" 
mouse buttons are defined: 


SELECT Used for selection and activation. SELECT is always 
mouse button 1 (the leftmost button,for a right- 
handed person). 
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ADJ UST 


TRANSFER 


MENU 


Used for adjusting and selection. ADJ UST is always 
Shift-+mouse button 1. In addition, on a three 
button mouse, with integrated selection and 
transfer, ADJ UST may optionally be assigned to 
mouse button 2. 


Used for data transfer and manipulation operations. 
With separate selection and transfer, TRANSFER is 
always assigned to mouse button 2. With integrated 
selection and transfer, TRANSFER is mouse button 
1 (integrated with SELECT), and on a three-button 
mouse, may also optionally be assigned to mouse 
button 2. 


Used to obtain pop-up menus. On a three-button 
mouse, MENU is always assigned to mouse button 3. 
On a two-button mouse with integrated selection 
and transfer, MENU is assigned to mouse button 2. 
Otherwise, MENU is assigned to Alt-+mouse button 
1. 


That is, on a two- or three-button Mouse, with Separated SELECTION and 
TRANSFER, the virtual mouse buttons are assigned as follows: 


SELECT 
ADJ UST 
TRANSFER 
MENU 


mouse button 1 
Shift-+enouse button 1 
mouse button 2 


mouse button 3 on a three-button mouse, or 
Alt-+nouse button 1 on a two-button mouse 


On a one, two-, or three-button mouse, with Integrated SELECTION and 
TRANSFER, the virtual mouse buttons are assigned as followed: 


SELECT 
ADJ UST 


TRANSFER 


MENU 


mouse button 1 (integrated with TRANSFER) 


Shift+mouse button 1. Optionally mouse button 2 on 
a three-button mouse 


mouse button 1 (integrated with SELECT) 
Optionally mouse button 2 on a three-button mouse. 


mouse button 3 on a three-button mouse, or mouse 
button 2 on a two-button mouse, or Alt-Hnouse 
button 1 on a one-button mouse. 
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Note - Ona three-button mouse, with integrated selection and transfer, 
if neither ADJ UST nor TRANSFER are assigned to mouse button 2, mouse 
button 2 may be used for application-defined purposes. 


Mouse Operations and Functions 


Table B-1 Mouse Operations and Functions 


Operation Name 
Activate 
Default Activate Open 


Open 


Manipulate 

Move Cursor 
Spring-Loaded Pull-down 
Menu 

Persistent Pull-down Menu 
Point Select 


Browse Select 


Group Click Select 
Group Swipe Select 
Point Toggle 


Group Click Toggle 


Group Swipe Toggle 


Function 
Activates a control that doesn’t have selections. 


Selects and performs default action on item 
Open. 


Opens view corresponding to icon Open. 


Manipulates nonselectable aspects of the 
interface (for example. scroll). 


Moves cursor to component or element. 


Displays persistent pull-down menu from 
cascade button. 


Displays persistent pull-down menu from 
cascade button. 


Selects an item if over one, deselecting other 
items (browse and extended selection). 


Shows which items can be selected, selecting 
one over which pointer is released. 


Selects a range or area of elements. 
Selects a range or area of elements. 


[select mode] Toggles selection state of an item 
(extended selection). 


[select mode] Toggles elements in range or area 
(extended selection). 


[select mode] Toggles elements in range or area 
(extended selection). 
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Table B-1 Mouse Operations and Functions (Continued) 


Operation Name 


Point Toggle 


Group Click Toggle 


Adjust Click 

Adjust Swipe 

Select Word 

Range Click Select Word 
Range Swipe Select Word 
Toggle Word 

Range Click Toggle Word 
Range Swipe Toggle Word 
Adjust Click Word 
Adjust Swipe Word 
Primary Copy 

Primary Move 

Primary Link 


Quick Copy 


Quick Move 


Quick Link 


Drag Transfer 


Drag Copy 


Drag Move 


Function 


[toggle mode] Toggles selection state of an item 


(single and multiple selection). 


[toggle mode] Toggles elements in range or area 


(multiple selection). 

Adjusts current selection region. 
Adjusts current selection region. 
Selects a word in text. 

Selects a range of words 

Selects a range of words. 

Toggles selection of a word. 
Toggles a range of words. 

Toggles a range of words. 

Adjusts selection to word boundary. 
Adjusts selection in word increments. 
Copies primary selection to pointer. 
Moves primary selection to pointer. 
Links primary selection to pointer. 


Makes and copies secondary selection to 
destination. 


Makes and move secondary selection to 
destination. 


Makes and link secondary selection to 
destination. 


Transfers dragged items to pointer (usually 
move). 


Copies dragged items to pointer. 


Moves dragged items to pointer. 
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Table B-1 Mouse Operations and Functions (Continued) 


Operation Name 
Drag Link 
Spring-Loaded Pop-up Menu 


Persistent Pop-up Menu 


Function 
Links dragged items to pointer. 
Displays spring-loaded pop-up menu. 


Displays persistent pop-up menu. 


Selectand Adjust Binding 
SELECT 


This is the virtual mouse button used for selection 


and activation. SELECT is always mouse button 1 
(the leftmost button, for a right-handed person). 


ADJ UST 


This is the virtual mouse button used for adjusting a 


selection. ADJ UST is always Shift+mouse button 1. 
In addition, on a three-button mouse, with 
integrated selection and transfer, ADJ UST may 
optionally be assigned to mouse button 2. 


Table B-2 Select and Adjust Key Bindings 


Operation Name 


Key Bindings 


Activate 

Default Activate 
Open 
Manipulate 
Move Cursor 


Spring-Loaded pull-down 
Menu 


Persistent pull-down Menu 
Point Select 

Browse Select 

Group Click Select 

Group Swipe Select 

Point Toggle 


SELECT Click 

SELECT DoubleClick 
SELECT DoubleClick 
SELECT Press, Move, Release 
Control+SELECT Click 
SELECT Press 


SELECT Click 

SELECT Click 

SELECT Press, Move, Release 
SELECT Click, Move, ADJ UST Click 
SELECT Press, Move, Release 
[select mode] Control+SELECT Click 
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Table B-2 Select and Adjust K ey Bindings (Continued) 


Operation Name 


Group Click Toggle 


Group Swipe Toggle 


Point Toggle 
Group Click Toggle 


Group Swipe Toggle 
Adjust Clock 

Adjust Swipe 

Adjust Click 

Adjust Swipe 

Select Word 

Range Click Select Word 
Range Swipe Select Word 
Toggle Word 

Range Click Toggle Word 


Range Swipe Toggle Word 
Adjust Click Word 

Adjust Swipe Word 
Adjust Click Word 

Adjust Swipe Word 


Key Bindings 


[select mode] Control+SELECT Click, Move, 
ADJ UST Click 


[select mode] Control+SELECT Press, Move, 
Release 


[toggle mode] SELECT Click 


[toggle mode] SELECT Click, Move, ADJ UST 
Click 


[toggle mode] SELECT Press, Move, Release 
AD] UST Click 

ADJ UST Press, Move, Release 

Control +ADJ UST Click 

Control+AD] UST Press, Move, Release 
SELECT DoubleClick 

SELECT DoubleClick, Move, Adjust Click 
SELECT Double Press, Move, Release 
Control+SELECT DoubleClick 


Control+SELECT DoubleClick, Move, ADJ UST 
Click 


Control+SELECT DoubleClick, Move, Release 
ADJ UST Double-Click 

AD) UST Double Press, Move, Release 
Control+ADJ UST DoubleClick 

Control+ADJ UST Double Press, Move, Release 
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Transfer Bindings 


TRANSFER This is the virtual mouse button which may be used 
for data transfer and manipulation operations. On a 
two- or three-button Mouse, with separate Selection 
and Transfer, TRANSFER is always assigned to 
mouse button 2. On a one., two-, or three-button 
Mouse, with Integrated Selection and Transfer, 
TRANSFER is always assigned to mouse button 1 
(integrated with SELECT). In addition, on a three 
button Mouse, with Integrated Selection and 
Transfer, TRANSFER may optionally be assigned to 
mouse button 2. 


Table B-3 Key Bindings When TRANSFER is Assigned Mouse Button 2 


Operation 
Name Key Bindings 


Manipulate TRANSFER Press, Move, Release 

Primary Copy TRANSFER Click 

Primary Copy Control+TRANSFER Click 

Primary Move Shift+TRANSFER Click 

Primary Link Control+Shift+TRANSFER Click 

Quick Copy AIt+TRANSFER Press, Move, Control+Release 
Quick Move AIt+TRANSFER Press, Move, Shift+Release 

Quick Link AIt+TRANSFER Press, Move, Control+Shift+Release 


The set of bindings in Table B-4 are always defined. When selection and 
transfer are integrated, Style Guide rules indicate when these bindings are 
used for transfer vs. selection. 


Table B-4 Key Bindings 


Operation Name _ Key Bindings 


Drag Transfer TRANSFER Press, Move, Release 
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Table B-4 Key Bindings 


Operation Name _ Key Bindings 


Drag Copy TRANSFER Press, Move, Control+Release 
Drag Move TRANSFER Press, Move, Shift+Release 
Drag Link TRANSFER Press, Move, 


Control +Shift+R elease 


Menu Bindings 


MENU is the virtual mouse button used to obtain popup menus. On a two- 
or three-button mouse, with separate SELECTION and TRANSFER: 


MENU mouse button 3 on a three button mouse, or 
Alt-+nouse button 1 on atwo-button mouse. 


On a one, two-, or three-button mouse, with integrated selection and 
transfer: 


MENU mouse button 3 on a three-button mouse, or mouse 
button 2 on a two-button mouse, or Alt-Hnouse 
button 1 on a one-button mouse. 


Table B-5 Menu Bindings 


Operation Name Key Bindings 
Spring-Loaded Popup Menu MENU Press 
Persistent Popup Menu MENU Click 
Spring-L oaded pull-down MENU Press 
Menu 

Persistent pull-down Menu MENU Click 
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canceling a selection 179 
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Gauge 9, 267 
List 255 
OptionButton 256 
PanedWindow 256 
Panel 257 
PushButton 257 
RadioButton 257 
Sash 258 
Scale 259 
ScrollBar 261 
SelectionBox 263 
Text 265 
input models 
input device model 155 
keyboard focus model 155 
navigation 
keyboard-based 5, 162 
menu traversal 166 
mouse-based 4, 158 
scrollable component 170 
overview 153-154 
preface key descriptions 154 
selection actions 180 
selection models 
autoscrolling and selection 179 
canceling a selection 179 
keyboard 176 
keyboard-based browse 
selection 177 
keyboard-based discontiguous 
selection 179 
keyboard-based multiple 
selection 177 
keyboard-based range 
selection 177 
keyboard-based single 
selection 177 
mouse-based browse 
selection 171 
mouse-based discontiguous 
selection 7, 174 
mouse-based multiple 
selection 6, 171 
mouse-based range selection 6, 
172 


mouse-based single 
selection 171 
overview 170 
selecting and deselecting 180 
using mnemonics for 
elements 180 
session management support 75, 
202 
transfer models 
clipboard transfer 183 
drag transfer 187 
overview 182 
primary transfer 185 
quick transfer 185 
window management 
icon 74 
icons 199 
window decorations 70, 197 
window navigation 199 
window support 197 
CheckButton 8, 247 
clipboard transfer 183 
color 
designing with 51 
dynamic 49 
philosphy 41 
usage in icons 48 
CommandBox 249 
Common Desktop Environment, 
introduction 1 
common user interface, advantages 1 
component activation 
accelerators 192 
basic activation 8, 191 
cance! activation 196 
default activation 194 
expert activation 195 
help activation 194 
mnemonics 8, 192 
previewing 196 
TearOff activation 193 
controls, groups, and models 
CheckButton 8, 247 
CommandBox 249 
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FileSelectionBox 249 
Gauge 9, 267 

List 255 
OptionButton 256 
PanedWindow 256 
Panel 257 
PushButton 257 
RadioButton 257 
Sash 258 

Scale 259 
ScrollBar 261 
SelectionBox 263 
Text 265 


D 


default activation 194 
designing drag-and-drop layout 231 
dialog box 
about 129 
design 101 
dragging from within 27 
layout 101 
placement 106 
print 121 
dialog box layout 220, 223, 230 
disabilities 
hearing 144 
language 145 
physical 142 
visual 143 
drag icon 
definition 11 
parts 17 
drag sources 24 
drag transfer 187 
drag-and-drop 
actions 22 
dialog box, from within 27 
drag sources, determining 24 
drop zones, supported 29 
ending 32 
feedback 16, 34 
File Manager 29 
Front Panel 29 
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matching operations 23 
mechanics 22 
multiple selection 28 
operation indicator 18 
performance 32 
placement upon drop 30 
source indicator 19 
state indicator 17 
types of objects 22 
user model 11 

drop point 31 

drop zone 11, 14, 29 


Edit menu contents layout 84, 211 
end of data, keyboard function 271 
end of line, keyboard function 271 
error messages 131 

expert activation 195 


F 

feedback for work in progress 98, 138, 
246 

Filemenu 81 

File menu contents layout 81, 208 

file selection dialog box layout 228 

FileSelectionBox 249 


G 


Gauge 9, 267 


H 


help 
online 134 


help activation 194 
Help menu contents layout 86, 214 


I 
icon 
alignment 62 
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application group 53 
Application Manager 45 
color palette 48 
definition 41 
design hints 50 
design philosophy 50 
document 54 
etched 63 
File Manager 43 
format 56 
Front Panel 45 
international 54 
minimized 46 
naming convention 60 
required 56 
sizes 59 
styles 51 
window 74 
input device model 155 
input devices 3 
input guidelines 4 
input models 
input device model 155 
keyboard focus model 155 
insert mode 276 
insert, keyboard function 276 
installation 
guideline 100 
interaction and application design 107, 
235 


K 

key assignments, accelerator keys 156, 
157, 158 

key assignments, by function 269 

key bindings 

mouse 287 

key descriptions, Certification 
Checklist 154 

keyboard focus model 155 


keyboard function 
activation 269 
backspace 269 


backtab 269 

beginning of data 269 
beginning of line 270 
cancel 270 

characters, deleting 270 


tab 276 

tutorial (choice) 277 
undo (choice) 277 
using help (choice) 277 
window list 277 


clearing 270 window menu 277 
closing 270 word left 277 
context-sensitive word right 277 

help 270 keyboard selection 176 
copying 270 keyboard-based browse selection 177 
eine keyboard-based discontiguous 
default action 270 ; 

. selection 179 

epee een eels keyboard-based multiple selection 177 
direct manipulation cancel 270 ie caeuaplintes ; P ies ‘ 
direct manipulation, canceling 270 keyboard-based navigation 5, 162 


drop-down list, displaying 271 keyboard-based range selection 177 


end of data 271 
end of line 271 
extending, selection 271 
help 
context sensitive 270 
overview choice 273 
hiding 273 
inserting a space 276 
key assignments 269 
keyboard (device), help 273 
maximizing 273 
minimizing 273 
moving 273 
moving, cursor 273 
new line 275 
page down 275 
page left 275 
page right 275 
page up 275 
paragraph down 275 
paragraph up 275 
pasting 275 


pop-up menu, displaying 275 


redo (choice) 275 
refresh 275 

restore 276 

select all 276 
selection 276 
selection, deleting 271 
size (choice) 276 
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keyboard-based single selection 177 


L 


List 255 


M 


MainWindow layout 77, 202 
Menu bar layout 205 
menu design 91 
menu design layout 91, 221 
menu traversal navigation 166 
messages 
error 131 
guidelines 132 
informational 131 
messages and application design 242 
Mnemonic Assignments 278 
mnemonics 8, 180, 192 
mode 
insert 276 
replace 276 
models for selection 170 
mouse 
button usage 30 
menu bindings 288 
select and adjust bindings 285 
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transfer bindings 287 
mouse functions 281 
mouse operation 

activate 283 

adjust click 284 

adjust swipe 284 

browse select 283 

drag copy 284 

drag link 285 

drag transfer 284 

group click select 283 

group click toggle 283 

group swipe select 283 

group swipe toggle 283 

manipulate 283 

move cursor 283 

open 283 

persistent pull-down menu 283 

point select 283 

point toggle 283 

primary copy 284 

primary link 284 

primary move 284 

quick copy 284 

quick link 284 

quick move 284 

select and adjust key bindings 285 

select word 284 

spring-loaded pull-down menu 283 

toggle word 284 
mouse-based browse selection 171 
mouse-based discontiguous selection 7, 

174 

mouse-based multiple selection 6, 171 
mouse-based range selection 6, 172 
mouse-based single selection 171 
multiple selection 28 


navigation 
keyboard-based 5, 162 
menu traversal 166 
mouse based 4 
mouse-based 4, 158 
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scrollable component 170 
new line, keyboard function 275 


O 


operation indicator 18 
OptionButton 256 

Options menu layout 86, 213 
overview of transfer models 182 


P 


page down, keyboard function 275 
page up, keyboard function 275 
PanedWindow 256 

Panel 257 

pop-up menus layout 216 
previewing 196 

primary transfer 185 

PushButton 257 


Q 


quick transfer 185 


R 


RadioButton 257 
replace mode 276 


S 


Sash 258 

Scale 259 

scrollable component navigation 170 

ScrollBar 261 

scrolling list 25 

Selected menu contents layout 83, 209 

selecting and deselecting elements 180 

selection actions 180 

selection models 
autoscrolling and selection 179 
canceling a selection 179 
keyboard 176 


keyboard-based browse 
selection 177 
keyboard-based discontiguous 
selection 179 
keyboard-based multiple 
selection 177 
keyboard-based range selection 177 
keyboard-based single selection 177 
mnemonics 180 
mouse-based browse selection 171 
mouse-based discontiguous 
selection 7, 174 
mouse-based multiple selection 6, 
171 
mouse-based range selection 6, 172 
mouse-based single selection 171 
overview 170 
selecting and deselecting 180 
SelectionBox 263 
session 
control 69 
session management support 75, 202 
source indicator 19 
state indicator 17 


T 


tab, keyboard function 276 

TearOff activation 193 

Text 265 

tool bar 47 
button 96 

tool bars 93 

transfer models 
clipboard transfer 183 
drag transfer 187 
overview 182 
primary transfer 185 
quick transfer 185 


V 


View menu layout 86, 213 
virtual keys 4 
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visual design 41 


Ww 


window 

control guidelines 69 

decorations 70 

expandable 108 

icon 74 

layout 77 

management 70 

menus 72 

placement 74 

titles 96 
window clustering 200 
window decorations 70, 197 
window management 

icon 74 

icons 199 

window decorations 70, 197 

window navigation 199 

window support 197 
window management actions 70, 201 
window navigation 199 
window placement 74, 199 
window support 197 
work-in-progress feedback 98, 138, 246 
workspace management 75 
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X/Open Motif Style Guide, relation to 2 
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